Die statische MethodeAtomics.add() addiert einen gegebenen Wert an einer gegebenen Position im Array und gibt den alten Wert an dieser Position zurück. Diese atomare Operation garantiert, dass keine anderen Schreibvorgänge stattfinden, bis der modifizierte Wert zurückgeschrieben wird.

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 werden soll.

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 der Grenzen destypedArray liegt.

Beispiele

Beachten Sie, dass diese Beispiele nicht direkt aus der Konsole oder auf einer beliebigen Webseite ausgeführt werden können, daSharedArrayBuffer nicht definiert ist, es sei denn, seineSicherheitsanforderungen sind erfüllt.

Verwendung von Atomics.add()

// Create a SharedArrayBuffer with a size in bytesconst sab = new SharedArrayBuffer(1024);// Create a view and set the value of the 0 indexconst ta = new Uint8Array(sab);ta[0] = 7;// 7 + 12 = 19console.log(Atomics.add(ta, 0, 12)); // 7, the old valueconsole.log(Atomics.load(ta, 0)); // 19, the new/current value

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Atomics
• Atomics.sub()