【Node.js24.x】Array::forEach()メソッドの使い方
forEachメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
forEachメソッドは、配列の各要素に対して一度ずつ、指定されたコールバック関数を実行するメソッドです。これはArrayクラスのプロトタイプに属しており、配列オブジェクトから直接呼び出すことができます。forEachメソッドは、引数として関数を受け取り、配列の最初の要素から最後の要素まで、インデックスの昇順でその関数を実行します。
コールバック関数は、現在処理中の配列の要素の値、その要素のインデックス、そしてforEachメソッドが呼び出された元の配列の3つの引数を自動的に受け取ります。これにより、各要素とその位置、または配列全体を参照しながら処理を行うことが可能です。
forEachメソッドの主な特徴として、ループを途中で中断する機能（例えば、break文やcontinue文のようなもの）は提供されていません。そのため、配列のすべての要素に対して必ず処理を実行したい場合に適しています。また、forEachメソッドは新しい配列を生成して返すわけではなく、常にundefinedを返します。このメソッドは、配列の内容を基にして何らかの副作用（例えば、コンソールへの出力、外部データの更新、既存のDOM要素への操作など）を実行するために主に利用されます。要素を変換して新しい配列を作成したい場合は、mapメソッドなどの別のメソッドを使用するのが一般的です。配列の要素を順に処理し、その処理結果に基づいて特定の動作を実行したい場合に、forEachメソッドは非常に役立ちます。
構文(syntax)
1const arrayName = ['item1', 'item2', 'item3']; 2 3arrayName.forEach(element => { 4 console.log(element); 5});
引数(parameters)
callbackFn, thisArg
- callbackFn: (element: any, index: number, array: any[]) => void: 配列の各要素に対して実行される関数。要素の値、インデックス、および配列自体を引数として受け取ります。
- thisArg: any: callbackFn を実行する際の
thisとして使用される値。
戻り値(return)
戻り値なし
戻り値はありません