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 der 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 dessen Wert initialValue, falls letzteres angegeben ist; andernfalls ist dessen Wert das erste Element des Iterators.

currentValue

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

currentIndex

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

initialValue Optional

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

Der Wert, der aus der vollständigen 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-Hilfemethoden funktioniert es nicht gut mit unendlichen Iteratoren, da es nicht lazy ist.

Im folgenden Beispiel wird ein Iterator erstellt, der Terme in der Fibonacci-Sequenz liefert, und dann werden die ersten zehn Terme summiert:

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
• Iterator
• Iterator.prototype.map()
• Iterator.prototype.flatMap()
• Array.prototype.reduce()