Set.prototype.forEach()

概要

Setオブジェクトの各値に対して一度挿入順で与えられた関数を実行します。

構文

mySet.forEach(callback[, thisArg])

引数

callback

各要素に対して実行する関数。

thisArg

callbackを実行するとき、thisとして使用する値。

説明

forEach メソッドはSetオブジェクトに実際に存在する各値に対して一度与えられたcallbackを実行します。削除された値に対しては呼び出されません。しかしながら、存在するがundefined値をもつ要素に対しては実行されます。

callbackは３つの引数で呼び出されます。:

• 要素値
• 要素値
• 対象となるSetオブジェクト

Setオブジェクトにキーはありません。しかしながら、最初の２つの引数は、両方ともSetに含まれる値です。そのため、 callback関数はMapやArrayのforEachメソッドと矛盾がありません。

thisArg 引数がforEachに与えられたら、呼び出されたときにthis値として使用するためにcallbackに渡されます。さもなければ、 undefined値がthis値として使用するために渡されます。callbackによって最終的に観測可能なthis 値は関数から見たthisを決定するための通常のルールに応じて決定されます。

forEachによって処理される要素の範囲は最初のcallbackの呼び出しより前に決定されます。forEachの呼び出しが始まったあとでSetオブジェクトに追加された要素は、callbackによって処理されません。Setのオブジェクト内の存在している要素が変更されたり削除されたら、callbackに渡される値は、forEachが処理するときの値になります。削除された要素は処理されません。

forEachはSetオブジェクト内の各要素に対して一度callback関数を実行します。forEachは値を返しません。

例

Set オブジェクトの内容を出力する。

次のコードでは、Setオブジェクト内の各要素に対して一行ログを出力します。:

function logSetElements(value1, value2, set) {
    console.log("s[" + value1 + "] = " + value2);
}

new Set(["foo", "bar", undefined]).forEach(logSetElements);

// logs:
// "s[foo] = foo"
// "s[bar] = bar"
// "s[undefined] = undefined"

仕様

ブラウザ実装状況

関連情報

• Array.prototype.forEach()
• Map.prototype.forEach()