Iterator.prototype.reduce()

¥Syntax

reduce(callbackFn)
reduce(callbackFn, initialValue)

¥Parameters

callbackFn

对迭代器生成的每个元素执行的函数。其返回值在下次调用 callbackFn 时成为 accumulator 参数的值。对于最后一次调用，返回值变为 reduce() 的返回值。使用以下参数调用该函数：

accumulator

上次调用 callbackFn 所产生的值。第一次调用时，如果指定了后者，则其值为 initialValue；否则它的值是迭代器的第一个元素。

currentValue

当前元素的值。在第一次调用时，如果指定了 initialValue，则其值为迭代器的第一个元素；否则其值为第二个元素。

currentIndex

currentValue 的索引位置。第一次调用时，如果指定了 initialValue，则其值为 0，否则为 1。

initialValue Optional

第一次调用回调时 accumulator 被初始化的值。如果指定了 initialValue，则 callbackFn 将从第一个元素作为 currentValue 开始执行。如果未指定 initialValue，则 accumulator 被初始化为第一个元素，callbackFn 以第二个元素作为 currentValue 开始执行。在这种情况下，如果迭代器为空（因此没有第一个值作为 accumulator 返回），则会引发错误。

¥Return value

在整个迭代器上运行 "reducer" 回调函数直至完成所产生的值。

¥The value that results from running the "reducer" callback function to completion over the entire iterator.

¥Exceptions

TypeError

如果迭代器不包含元素且未提供 initialValue，则抛出该异常。

¥Description

有关 reduce() 如何工作的详细信息，请参阅 Array.prototype.reduce()。与大多数其他迭代器辅助方法不同，它不能很好地处理无限迭代器，因为它不是惰性的。

¥See Array.prototype.reduce() for details about how reduce() works. Unlike most other iterator helper methods, it does not work well with infinite iterators, because it is not lazy.

¥Examples

¥Using reduce()

以下示例创建一个迭代器，该迭代器生成斐波那契数列中的项，然后对前十项求和：

¥The following example creates an iterator that yields terms in the Fibonacci sequence, and then sums the first ten terms:

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

¥See also

• core-js 中 Iterator.prototype.reduce 的 Polyfill
• Iterator
• Iterator.prototype.map()
• Iterator.prototype.flatMap()
• Array.prototype.reduce()