База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.reduce: редукция до една стойност

reduce посещава съществуващите елементи и ги комбинира чрез акумулатор в една стойност.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.reduce(callbackFn[, initialValue])

array.reduce(callbackFn[, initialValue]) извиква callbackFn(accumulator, currentValue, index, array) за съществуващите индекси във възходящ ред и връща крайния акумулатор. С initialValue започва от тази стойност. Без нея първият съществуващ елемент става акумулатор и не се подава като currentValue.

Дупките се пропускат. Празен масив или масив само с дупки без initialValue хвърля TypeError; явно undefined се брои за подадена начална стойност. Дължината се запомня преди итерацията: по-късни добавяния след нея се игнорират, а навреме изтрит още непосетен индекс се пропуска. Методът сам не променя получателя и е общ за array-like; callback, който не е функция, получател null или undefined и грешки в callback хвърлят изключение.

Примери

const sparse = [, 2, , 4];
const steps = [];
const total = sparse.reduce((accumulator, value, index) => {
  steps.push(index + ":" + accumulator + "+" + value);
  return accumulator + value;
}, 1);
console.log(total);
console.log(steps.join("|"));
console.log([, 5, ,].reduce((a, b) => a + b));
try { [].reduce((a, b) => a + b); } catch (error) { console.log(error.name); }

Резултат

7
1:1+2|3:3+4
5
TypeError

Източници