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

瀏覽器相容性

另見