Map.prototype.forEach()

Summary

挿入順にMapのキー／バリューペアあたり一回、提供された関数を実行します。

構文

myMap.forEach(callback[, thisArg])

引数

callback

それぞれの要素に対して実行する関数

thisArg

callbackを実行するときに、thisとして使う値

説明

forEach メソッドは実際に存在するマップのキーに対して一回提供されたcallbackを実行します。削除されたキーに対しては呼び出されません。しかしながら、存在するがundefinedを持つ値に対しては実行されます。

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

• 要素の値
• 要素のキー
• 実行されるMap オブジェクト

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

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

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

例

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

The following code logs a line for each element in an Map object:

function logMapElements(value, key, map) {
    console.log("m[" + key + "] = " + value);
}
Map([["foo", 3], ["bar", {}], ["baz", undefined]]).forEach(logMapElements);
// logs:
// "m[foo] = 3"
// "m[bar] = [object Object]"
// "m[baz] = undefined"

仕様

ブラウザ実装状況

関連情報

• Array.prototype.forEach()
• Set.prototype.forEach()