Iterator.prototype.forEach()
Baseline 2025Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
forEach() は Iterator インスタンスのメソッドで、 Array.prototype.forEach() と似ています。指定された関数を、イテレーターによって生成されたそれぞれの要素に対して 1 回ずつ指定された関数を実行します。
構文
js
forEach(callbackFn)
引数
callbackFn-
イテレーターによって生成された各要素に対して実行する関数。その返値は破棄されます。関数は次の引数で呼び出されます。
返値
undefined です。
解説
forEach() はイテレーターを反復処理し、それぞれの要素に対して一度ずつ callbackFn 関数を呼び出します。 他のほとんどのイテレーターヘルパーメソッドとは異なり、これは遅延的ではないため、無限イテレーターでは動作しません。
例
forEach() の使用
js
new Set([1, 2, 3]).values().forEach((v) => console.log(v));
// ログ出力:
// 1
// 2
// 3
これは次のものと同等です。
js
for (const v of new Set([1, 2, 3]).values()) {
console.log(v);
}
仕様書
| Specification |
|---|
| Iterator Helpers # sec-iteratorprototype.foreach |