Atomics.load()

Статический метод Atomics.load() возвращает значение по указанной позиции в массиве. Эта атомарная операция гарантирует, что чтение будет целостным (tear-free) и что все атомарные чтения будут последовательно согласованы.

Синтаксис

Atomics.load(typedArray, index)

Параметры

typedArray

Целочисленный типизированный массив. Один из Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array или BigUint64Array.

index

Позиция в typedArray для загрузки.

Возвращаемое значение

Значение по указанной позиции (typedArray[index]).

Исключения

TypeError

Выбрасывается, если typedArray не является одним из разрешенных целочисленных типов.

RangeError

Выбрасывается, если index выходит за пределы допустимого диапазона в typedArray.

Примеры

Обратите внимание, что эти примеры нельзя запустить напрямую из консоли или произвольной веб-страницы, поскольку SharedArrayBuffer не определен, если не выполнены его требования безопасности.

Использование Atomics.load()

// Create a SharedArrayBuffer with a size in bytes
const sab = new SharedArrayBuffer(1024);
// Create a view and set the value of the 0 index
const ta = new Uint8Array(sab);
ta[0] = 7;

Atomics.add(ta, 0, 12); // Add 12 to index 0
console.log(Atomics.load(ta, 0)); // 19, the new/current value

Спецификации

Совместимость с браузерами

См. также

• Atomics
• Atomics.store()