Iterator.prototype.reduce()

callbackFn

Eine Funktion, die für jedes vom Iterator erzeugte Element ausgeführt wird. Ihr Rückgabewert wird zum Wert des accumulator-Parameters beim nächsten Aufruf von callbackFn. Beim letzten Aufruf wird der Rückgabewert zum Rückgabewert von reduce(). Die Funktion wird mit den folgenden Argumenten aufgerufen:

accumulator

Der Wert, der aus dem vorherigen Anruf von callbackFn resultiert. Beim ersten Aufruf ist sein Wert initialValue, wenn letzterer angegeben ist; andernfalls ist sein Wert das erste Element des Iterators.

currentValue

Der Wert des aktuellen Elements. Beim ersten Aufruf ist sein Wert das erste Element des Iterators, wenn initialValue angegeben ist; andernfalls ist sein Wert das zweite Element.

currentIndex

Die Indexposition von currentValue. Beim ersten Aufruf ist sein Wert 0, wenn initialValue angegeben ist, andernfalls 1.

initialValue Optional

Ein Wert, mit dem accumulator beim ersten Aufruf des Callback initialisiert wird. Wenn initialValue angegeben ist, beginnt callbackFn mit dem ersten Element als currentValue zu arbeiten. Wenn initialValue nicht angegeben ist, wird accumulator mit dem ersten Element initialisiert, und callbackFn beginnt mit dem zweiten Element als currentValue. In diesem Fall, wenn der Iterator leer ist (sodass es keinen ersten Wert gibt, der als accumulator zurückgegeben werden kann), wird ein Fehler ausgelöst.

Der Wert, der durch die vollständige Ausführung der "Reducer"-Callback-Funktion über den gesamten Iterator resultiert.

TypeError

Wird ausgelöst, wenn der Iterator keine Elemente enthält und initialValue nicht bereitgestellt wird.

Siehe Array.prototype.reduce() für Details darüber, wie reduce() funktioniert. Im Gegensatz zu den meisten anderen Iterator-Hilfsmethoden funktioniert es nicht gut mit unendlichen Iteratoren, da es nicht "lazy" ist.

Das folgende Beispiel erstellt einen Iterator, der Terme in der Fibonacci-Sequenz liefert, und summiert dann die ersten zehn Terme:

function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

console.log(
  fibonacci()
    .take(10)
    .reduce((a, b) => a + b),
); // 143

• Polyfill von Iterator.prototype.reduce in core-js
• es-shims Polyfill von Iterator.prototype.reduce
• Iterator
• Iterator.prototype.map()
• Iterator.prototype.flatMap()
• Array.prototype.reduce()