Atomics.load()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Dezember 2021 browserübergreifend verfügbar.
Die Atomics.load() statische Methode gibt einen Wert an einer bestimmten Position im Array zurück. Diese atomare Operation garantiert, dass das Lesen fehlerfrei ist und alle atomaren Lesevorgänge sequentiell konsistent sind.
Syntax
Atomics.load(typedArray, index)
Parameter
typedArray-
Ein ganzzahliges getyptes Array. Eines von
Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64ArrayoderBigUint64Array. index-
Die Position im
typedArray, von der geladen werden soll.
Rückgabewert
Der Wert an der angegebenen Position (typedArray[index]).
Ausnahmen
TypeError-
Wird ausgelöst, wenn
typedArraynicht einer der erlaubten Ganzzahltypen ist. RangeError-
Wird ausgelöst, wenn
indexaußerhalb der Grenzen destypedArrayliegt.
Beispiele
Beachten Sie, dass diese Beispiele nicht direkt von der Konsole oder einer beliebigen Webseite aus ausgeführt werden können, da SharedArrayBuffer nicht definiert ist, es sei denn, seine Sicherheitsanforderungen sind erfüllt.
Verwendung von 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
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-atomics.load |