【Node.js24.x】Set::forEach()メソッドの使い方
forEachメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
forEachメソッドは、Setオブジェクトに格納されている各要素に対して、引数として渡された関数(コールバック関数)を一度ずつ実行するメソッドです。Setは重複しないユニークな値の集合であり、このメソッドを使用することで、Set内のすべての要素に対して一貫した処理を適用できます。
コールバック関数は、3つの引数を受け取ります。最初の引数は現在処理されているSetの要素の値、2番目の引数もSetの要素の値(Setにおいてはキーと値が同じになります)、そして3番目の引数はforEachメソッドが呼び出された元のSetオブジェクト自身です。これにより、要素の値だけでなく、そのSet全体を参照しながら処理を行うことが可能です。
Setは要素の格納順序を保証しないため、コールバック関数が実行される要素の順序も保証されません。また、オプションで2番目の引数thisArgを指定することで、コールバック関数内でthisとして参照されるオブジェクトを設定できます。forEachメソッド自体は、値を返しません。
このメソッドは、Setに含まれるデータ項目それぞれに対して、ログ出力、条件判定、別データ構造への変換といった一連の操作を行いたい場合に、シンプルかつ効率的な方法を提供します。システム開発において、データの集合を扱う際に頻繁に利用される基本的な処理の一つです。
構文(syntax)
1const mySet = new Set(['element1', 'element2', 'element3']); 2 3mySet.forEach((value, key, set) => { 4 console.log(value, key, set); 5});
引数(parameters)
callbackFn, thisArg = undefined
- callbackFn: (value, value2, set) => void: Set の各要素に対して実行されるコールバック関数。
- value: 現在処理中の要素の値。
- value2: 現在処理中の要素の値(Set の forEach では value と同じ)。
- set: forEach メソッドが呼び出された Set オブジェクト自体。
- thisArg = undefined: callbackFn が実行される際に this として使用される値。省略可能。
戻り値(return)
戻り値なし
戻り値はありません