TypedArray.prototype.forEach()

概要

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

構文

typedarray.forEach(callback[, thisArg])

引数

callback

新しいtyped arrayの要素を生成する関数。三つの引数を取ります。:

currentValue

typed array内で処理される現在の要素。

index

配列内で処理される現在の要素のインデックス。

array

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

thisArg

オプション。callbackを実行するときthisとして使用する値

説明

forEach() メソッドはtyped array内に存在している各要素に対して一度昇順に与えられたcallback関数を実行します。;削除されたり、省略されたインデックスに対しては呼び出されません。しかしながら、存在しているが、undefined値を持つ要素に対しては実行されます。

callback三つの引数で呼び出されます。:

• 要素の値
• 要素のインデックス
• 処理されるtyped array

thisArg引数がforEach()に与えられたら、呼び出されるときにthis値として使用するためにcallback関数に渡されます。さもなければ、undefined値がthis値として使用するために渡されます。callbackによって最終的に観測可能なthis値はthe usual rules for determining the this seen by a functionに応じて決定されます。

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

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

例

例: typed arrayの内容をログに出力する

次のコードでは、 typed array内の各要素に対して一行ログを出力します。:

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()