Atomics.add()
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.add() statische Methode fügt an einer gegebenen Position im Array einen Wert hinzu und gibt den alten Wert an dieser Position zurück. Diese atomare Operation stellt sicher, dass kein anderer Schreibvorgang stattfindet, bis der geänderte Wert zurückgeschrieben wird.
Probieren Sie es aus
// Create a SharedArrayBuffer with a size in bytes
const buffer = new SharedArrayBuffer(16);
const uint8 = new Uint8Array(buffer);
uint8[0] = 7;
// 7 + 2 = 9
console.log(Atomics.add(uint8, 0, 2));
// Expected output: 7
console.log(Atomics.load(uint8, 0));
// Expected output: 9
Syntax
Atomics.add(typedArray, index, value)
Parameter
typedArray-
Ein Integer-Typ-Array. Eines von
Int8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64ArrayoderBigUint64Array. index-
Die Position im
typedArray, an der einvaluehinzugefügt wird. value-
Die Zahl, die hinzugefügt werden soll.
Rückgabewert
Der alte Wert an der angegebenen Position (typedArray[index]).
Ausnahmen
TypeError-
Wird ausgelöst, wenn
typedArraynicht einer der erlaubten Integer-Typen ist. RangeError-
Wird ausgelöst, wenn
indexaußerhalb des zulässigen Bereichs imtypedArrayliegt.
Beispiele
Verwendung von add()
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
Atomics.add(ta, 0, 12); // returns 0, the old value
Atomics.load(ta, 0); // 12
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-atomics.add |
Browser-Kompatibilität
Loading…