Atomics.load()
The static Atomics.load()
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
, orBigUint64Array
. index
-
The position in the
typedArray
to load from.
Return value
The value at the given position (typedArray[index]
).
Exceptions
-
Throws a
TypeError
, iftypedArray
is not one of the allowed integer types. -
Throws a
RangeError
, ifindex
is out of bounds in thetypedArray
.
Examples
Using load
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
Atomics.add(ta, 0, 12);
Atomics.load(ta, 0); // 12
Specifications
Specification |
---|
ECMAScript Language Specification # sec-atomics.load |
Browser compatibility
BCD tables only load in the browser