【Node.js24.x】Map::forEach()メソッドの使い方
forEachメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
forEachメソッドは、Mapオブジェクトが保持する各キーと値のペアに対し、指定されたコールバック関数を一度ずつ実行するメソッドです。このメソッドを使用することで、Map内のすべての要素を、要素が追加された順序で順序通りに処理できます。
コールバック関数は、各要素が処理されるたびに呼び出され、以下の3つの引数を受け取ります。1つ目は現在の要素の値（value）、2つ目は現在の要素のキー（key）、そして3つ目はforEachメソッドが呼び出されたMapオブジェクト自身です。これらの引数を利用して、コールバック関数内で現在の要素の情報に基づいた処理を実行できます。
また、forEachメソッドはオプションの第2引数としてthisArgを受け取ります。このthisArgを指定すると、コールバック関数内でthisキーワードが参照するオブジェクトを任意に設定できます。これは、コールバック関数を特定のコンテキストで実行したい場合に有効です。
forEachメソッド自体は、反復処理を終えた後に特定の値を返しません（常にundefinedを返します）。このメソッドは、Mapオブジェクト内の全要素に対して何らかの処理を実行したい場合、例えば、各要素をログに出力したり、特定の条件を満たす要素に対して特定の操作を行ったりする際に非常に便利です。Mapの内容に基づいて新しいデータ構造を作成する目的には適していません。
構文(syntax)
1const myMap = new Map(); 2myMap.set('name', 'Alice'); 3myMap.set('age', 30); 4myMap.set('city', 'New York'); 5 6myMap.forEach((value, key, map) => { 7 console.log(`Key: ${key}, Value: ${value}`); 8});
引数(parameters)
callbackFn, thisArg
- callbackFn: function: 各要素に対して実行されるコールバック関数。この関数は
value,key,mapの3つの引数を受け取ります。 - thisArg: any:
callbackFnを実行する際のthisとして使用される値。
戻り値(return)
戻り値なし
戻り値はありません