Atomics.load()

静的な Atomics.load() メソッドは、配列内の指定された位置の値を返します。

試してみましょう

構文

js
Atomics.load(typedArray, index);

引数

typedArray

整数の型付き配列です。 Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array の何れかです。

index

typedArray の中で値を読み込む位置。

返値

指定された位置 (typedArray[index]) にある値です。

例外

  • typedArray が許可された整数型の何れでもない場合、TypeError が発生します。
  • indextypedArray の範囲を超えている場合、 RangeError が発生します。

load の使用

js
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);

Atomics.add(ta, 0, 12);
Atomics.load(ta, 0); // 12

仕様書

Specification
ECMAScript Language Specification
# sec-atomics.load

ブラウザーの互換性

BCD tables only load in the browser

関連情報