WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.reduce: auf einen Wert reduzieren

reduce besucht vorhandene Elemente und verbindet sie über einen Akkumulator zu einem Wert.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.reduce(callbackFn[, initialValue])

array.reduce(callbackFn[, initialValue]) ruft callbackFn(accumulator, currentValue, index, array) für vorhandene Indizes aufsteigend auf und liefert den letzten Akkumulator. Mit initialValue beginnt es bei diesem Wert. Ohne ihn wird das erste vorhandene Element Akkumulator und nicht als currentValue an den Callback übergeben.

Lücken werden übersprungen. Ein leeres oder nur aus Lücken bestehendes Array ohne initialValue löst TypeError aus; ausdrückliches undefined gilt als angegebener Startwert. Die Länge wird vor der Iteration erfasst: spätere Anhänge dahinter werden ignoriert, ein rechtzeitig gelöschter noch nicht besuchter Index übersprungen. Die Methode selbst mutiert nicht und ist für array-ähnliche Werte generisch; ein nicht aufrufbarer Callback, null oder undefined als Empfänger und Callbackfehler lösen Fehler aus.

Beispiele

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); }

Ergebnis

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

Quellen