Iterator.prototype.forEach()
Baseline
2025
最近利用可能
March 2025以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
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);
}
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-iterator.prototype.foreach |