この翻訳は不完全です。英語から この記事を翻訳 してください。

Mapのキー/バリューペアに対して一回ずつ、挿入順に指定された関数を実行します。

構文

myMap.forEach(callback[, thisArg])

引数

callback
それぞれの要素に対して実行する関数
thisArg
callbackを実行するときに、thisとして使う値

戻り値

undefined.

説明

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

callback3つの引数で呼び出されます。:

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

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

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

forEachMapオブジェクトの要素に対して一回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}`);
}
new Map([['foo', 3], ['bar', {}], ['baz', undefined]]).forEach(logMapElements);
// logs:
// "m[foo] = 3"
// "m[bar] = [object Object]"
// "m[baz] = undefined"

仕様

仕様 ステータス コメント
ECMAScript 2015 (6th Edition, ECMA-262)
Map.prototype.forEach の定義
標準 Initial definition.
ECMAScript Latest Draft (ECMA-262)
Map.prototype.forEach の定義
ドラフト  

ブラウザ実装状況

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応38122511258
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応38381225258 あり

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: woodmix, shide55
 最終更新者: woodmix,