Iterator.prototype.forEach()

基准线 2025
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的设备和浏览器版本上使用。此功能可能在旧设备或浏览器上无法正常工作。

Iterator 实例的 forEach() 方法与 Array.prototype.forEach() 类似:它会为迭代器产生的每个元素执行一次提供的函数。

语法

js
forEach(callbackFn)

参数

callbackFn

为迭代器产生的每个元素执行的函数。其返回值将被忽略。该函数会以以下参数调用:

element

正在处理的当前元素。

index

正在处理的当前元素的索引。

返回值

undefined.

描述

forEach() 会迭代器并为每个元素调用一次 callbackFn 函数。与其他大多数迭代器辅助方法不同,它不适用于无限迭代器,因为它不是惰性的。

示例

使用 forEach()

js
new Set([1, 2, 3]).values().forEach((v) => console.log(v));

// Logs:
// 1
// 2
// 3

这等价于

js
for (const v of new Set([1, 2, 3]).values()) {
  console.log(v);
}

规范

规范
ECMAScript® 2026 语言规范
# sec-iterator.prototype.foreach

浏览器兼容性

另见