Iterator.prototype.reduce()

callbackFn

Eine Funktion, die für jedes vom Iterator erzeugte Element ausgeführt wird. Ihr Rückgabewert wird der 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 sich aus dem vorherigen Aufruf von callbackFn ergibt. Beim ersten Aufruf ist sein Wert initialValue, falls 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 Callbacks initialisiert wird. Wenn initialValue angegeben ist, beginnt die Ausführung von callbackFn mit dem ersten Element als currentValue. Wenn initialValue nicht angegeben ist, wird accumulator auf das erste Element initialisiert, und callbackFn beginnt die Ausführung mit dem zweiten Element als currentValue. In diesem Fall, wenn der Iterator leer ist (also kein erster Wert als accumulator zurückzugeben ist), wird ein Fehler ausgelöst.

Der Wert, der sich aus der vollständigen Ausführung der "Reducer"-Callback-Funktion über den gesamten Iterator ergibt.

TypeError

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

Siehe Array.prototype.reduce() für Details dazu, 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 addiert 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()