Atomics.store()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2021.
The Atomics.store()
static
method stores a given value at the given position in the array and returns that value.
Try it
Syntax
js
Atomics.store(typedArray, index, value)
Parameters
typedArray
-
An integer typed array. One of
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
,Uint32Array
,BigInt64Array
, orBigUint64Array
. index
-
The position in the
typedArray
to store avalue
in. value
-
The number to store.
Return value
The value that has been stored.
Exceptions
TypeError
-
Thrown if
typedArray
is not one of the allowed integer types. RangeError
-
Thrown if
index
is out of bounds in thetypedArray
.
Examples
Using store()
js
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
Atomics.store(ta, 0, 12); // 12
Specifications
Specification |
---|
ECMAScript Language Specification # sec-atomics.store |
Browser compatibility
BCD tables only load in the browser