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
// Create a SharedArrayBuffer with a size in bytes const buffer = new SharedArrayBuffer(16); const uint8 = new Uint8Array(buffer); uint8[0] = 5; // 5 + 2 = 7 console.log(Atomics.add(uint8, 0, 2)); // Expected output: 5 console.log(Atomics.load(uint8, 0)); // Expected output: 7 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
typedArrayto load from.
Return value
The value at the given position (typedArray[index]).
Exceptions
TypeError-
Thrown if
typedArrayis not one of the allowed integer types. RangeError-
Thrown if
indexis 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® 2026 Language Specification # sec-atomics.load |