TypedArray.prototype.forEach()

forEach() メソッドは、配列の要素ごとに一度与えられた関数を実行します。このメソッドは Array.prototype.forEach() と同じアルゴリズムを持っています。ここで TypedArray は型付き配列型の一つです。

構文

typedarray.forEach(callback[, thisArg])

引数

callback

新しい型付き配列の要素を生成する関数。三つの引数を取ります。

currentValue

型付き配列内で処理される現在の要素。

index

配列内で処理される現在の要素の添字。

array

forEach() が呼び出される配列。

thisArg Optional

callback を実行するとき this として使用する値

返値

undefined です。

解説

forEach() メソッドは与えられた callback を、型付き配列内に存在するそれぞれの要素に一度ずつ昇順に実行します。削除されたり、省略されたりしたインデックスに対しては呼び出されません。ただし、存在していて undefined の値を持つ要素に対しては実行されます。

callback は次の 3 つの引数で呼び出されます。

• 要素の値
• 要素の添字
• 走査中の型付き配列

thisArg 引数が forEach() に与えられた場合は、 callback の呼び出し時にそのオブジェクトが this の値として使用されます。与えられなかった場合は、 undefined が this の値として使用するために渡されます。 callback によって最終的に観測可能な this 値は関数から見える this を特定する一般規則に従います。

forEach() によって処理される要素の範囲は callback の最初の呼び出し前に設定されます。 forEach() の呼び出しが始まったあとで型付き配列に追加される要素は、 callback によって処理されます。typed array内に存在している要素の値が変更されたら、 callback に渡される値は、forEach()メソッドが処理する直前の値です。つまり、処理される前に削除されている要素は処理されません。

forEach() は型付き配列の各要素ごとに一度 callback 関数を実行します。 every() や some() とは異なり、常に、 undefined 値を返します。

例

型付き配列の内容をログに出力する

以下のコードは型付き配列内の各要素を1行ずつ出力します。

function logArrayElements(element, index, array) {
  console.log('a[' + index + '] = ' + element);
}

new Uint8Array([0, 1, 2, 3]).forEach(logArrayElements);
// logs:
// a[0] = 0
// a[1] = 1
// a[2] = 2
// a[3] = 3

仕様書

ブラウザーの互換性

関連情報

• TypedArray.prototype.map()
• TypedArray.prototype.every()
• TypedArray.prototype.some()
• Array.prototype.forEach()