Atomics.load()
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.load()
static
method returns a value at a given position in the array.
Try it
Syntax
js
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
TypeError
-
Thrown if
typedArray
is not one of the allowed integer types. RangeError
-
Thrown if
index
is out of bounds in thetypedArray
.
Examples
Using load
js
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
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
load |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.