【JavaScript ECMAScript】TypedArray::TypedArray.prototype.forEachインスタンスメソッドの使い方

TypedArray.prototype.forEach()メソッドは、TypedArrayオブジェクトの各要素に対して、一度ずつ指定されたコールバック関数を実行するメソッドです。このメソッドは、JavaScriptにおいて固定長のバイナリデータを効率的に扱うためのTypedArrayインスタンスが持つ要素を、順番に処理したい場合に非常に便利です。例えば、グラフィック処理や音声処理などで使用される数値データに対して、特定の操作を適用したり、情報を集計したりする際に役立ちます。

このメソッドは、第一引数として「callbackFn」と呼ばれる関数を受け取ります。このcallbackFnは、TypedArrayの各要素に対して呼び出され、その際に現在の要素の値、現在の要素のインデックス（配列内の位置）、そしてforEach()が呼び出された元のTypedArrayオブジェクト自身が引数として渡されます。開発者はこのcallbackFnの中に、各要素に対して行いたい処理を記述します。第二引数の「thisArg」は任意で、callbackFn内でthisとして参照する値を指定できます。

forEach()メソッドは、全ての要素に対してcallbackFnの実行が完了すると、特に値を返さずにundefinedを返します。これは、新しいTypedArrayを生成したり、元のTypedArrayの要素を直接変更したりするのではなく、単に各要素に対する処理を実行する役割に特化しているためです。そのため、配列の要素を一つずつ処理するループ処理を、従来のfor文よりも簡潔に記述したい場合に活用されます。ただし、ループの途中で処理を中断する機能は持っていません。

Copy
1const typedArray = new Int32Array([10, 20, 30, 40, 50]);
2
3typedArray.forEach((currentValue, index, array) => {
4  console.log(`要素 ${index}: ${currentValue} (全配列: ${array})`);
5});

callbackFn, thisArg = undefined

• callbackFn: arrayLike.ArrayBuffer.forEachcallbackFn: 各要素に対して実行されるコールバック関数。以下の3つの引数を受け取ります：
  • element: number: 配列内の現在の要素の値。
  • index: number: 配列内の現在の要素のインデックス。
  • array: arrayLike: forEach()メソッドが呼び出されたTypedArrayオブジェクト。
• thisArg: any = undefined: コールバック関数内でthisとして使用される値。指定しない場合、undefinedが使用されます。

戻り値なし

戻り値はありません