TypedArray.prototype.forEach()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年9月以降、すべてのブラウザーで利用可能です。
forEach() は TypedArray インスタンスのメソッドで、型付き配列の要素ごとに一度与えられた関数を実行します。このメソッドのアルゴリズムは Array.prototype.forEach() と同じです。
試してみましょう
const uint8 = new Uint8Array([10, 20, 30]);
uint8.forEach((element) => console.log(element));
// 予想される結果: 10
// 予想される結果: 20
// 予想される結果: 30
構文
js
forEach(callbackFn)
forEach(callbackFn, thisArg)
引数
callbackFn-
型付き配列のそれぞれの要素に対して実行する関数です。返値は破棄されます。この関数は以下の引数で呼び出されます。
thisArg省略可-
callbackFnを実行する際にthisとして使用する値。反復処理メソッドを参照してください。
返値
なし (undefined)。
解説
詳細については、 Array.prototype.forEach() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。
例
型付き配列の内容をログに出力する
以下のコードは型付き配列内の各要素を 1 行ずつ出力します。
js
function logArrayElements(element, index, array) {
console.log(`a[${index}] = ${element}`);
}
new Uint8Array([0, 1, 2, 3]).forEach(logArrayElements);
// 出力:
// a[0] = 0
// a[1] = 1
// a[2] = 2
// a[3] = 3
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-%typedarray%.prototype.foreach |