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 Dezember 2021.
Die Atomics.store() statische Methode speichert einen gegebenen Wert an einer gegebenen Position im Array und gibt diesen Wert zurück. Diese atomare Operation garantiert, dass das Schreiben ohne Risse erfolgt und dass alle atomaren Schreiboperationen sequentiell konsistent sind.
Beachten Sie, dass im Gegensatz zu vielen anderen Atomic-Methoden store() den neuen Wert und nicht den alten Wert zurückgibt. Um den alten Wert zu erhalten, verwenden Sie stattdessen Atomics.exchange().
Syntax
Atomics.store(typedArray, index, value)
Parameter
typedArray-
Ein ganzzahliges typisiertes Array. Eines von
Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64ArrayoderBigUint64Array. index-
Die Position im
typedArray, an der einvaluegespeichert werden soll. value-
Die Zahl, die gespeichert werden soll.
Rückgabewert
Der Wert, der gespeichert wurde.
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, die Sicherheitsanforderungen sind erfüllt.
Verwendung von Atomics.store()
// Create a SharedArrayBuffer with a size in bytes
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
console.log(Atomics.store(ta, 0, 12)); // 12, the new/current value
console.log(Atomics.load(ta, 0)); // 12, the new/current value
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-atomics.store |