The Atomics.load() static method returns a value at a given position in the array.

Syntax

Atomics.load(typedArray, index)

Parameters

• typedArray
  • : An integer typed array. One of Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array, or BigUint64Array.
• index
  • : The position in the typedArray to load from.

Return value

The value at the given position (typedArray[index]).

Exceptions

• TypeError
  • : Thrown if typedArray is not one of the allowed integer types.
• RangeError
  • : Thrown if index is out of bounds in the typedArray.

Examples

Using load

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

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

Specifications

Browser compatibility

See also

• Atomics
• Atomics.store