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 December 2021.
Die statische Methode Atomics.add()
fügt einen angegebenen Wert an einer angegebenen Position im Array hinzu und gibt den alten Wert an dieser Position zurück. Dieser atomare Vorgang garantiert, dass kein anderer Schreibvorgang erfolgt, bis der modifizierte Wert zurückgeschrieben wird.
Probieren Sie es aus
Syntax
Atomics.add(typedArray, index, value)
Parameter
typedArray
-
Ein ganzzahliges Typ-Array. Eines von
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
,Uint32Array
,BigInt64Array
oderBigUint64Array
. index
-
Die Position im
typedArray
, 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, wenn
typedArray
nicht einer der erlaubten ganzzahligen Typen ist. RangeError
-
Wird ausgelöst, wenn
index
außerhalb der Grenzen 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 value
Atomics.load(ta, 0); // 12
Spezifikationen
Specification |
---|
ECMAScript Language Specification # sec-atomics.add |
Browser-Kompatibilität
BCD tables only load in the browser