Iterator.prototype.forEach()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used 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 |
ブラウザーの互換性
BCD tables only load in the browser