DieAtomics.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 bytesconst buffer = new SharedArrayBuffer(16);const uint8 = new Uint8Array(buffer);uint8[0] = 7;// 7 + 2 = 9console.log(Atomics.add(uint8, 0, 2));// Expected output: 7console.log(Atomics.load(uint8, 0));// Expected output: 9

Syntax

Atomics.add(typedArray, index, value)

Parameter

typedArray

Ein Integer-Typ-Array. Eines vonInt8Array,Uint8Array,Int16Array,Uint16Array,Int32Array,Uint32Array,BigInt64Array oderBigUint64Array.

index

Die Position imtypedArray, an der einvalue hinzugefü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, wenntypedArray nicht einer der erlaubten Integer-Typen ist.

RangeError

Wird ausgelöst, wennindex außerhalb des zulässigen Bereichs imtypedArray liegt.

Beispiele

Verwendung von add()

const sab = new SharedArrayBuffer(1024);const ta = new Uint8Array(sab);Atomics.add(ta, 0, 12); // returns 0, the old valueAtomics.load(ta, 0); // 12

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Atomics
• Atomics.sub()