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

js
Atomics.add(typedArray, index, value)

Parameter

typedArray

Ein ganzzahliges Typ-Array. Eines von Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array oder BigUint64Array.

index

Die Position im typedArray, an der ein value 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 im typedArray liegt.

Beispiele

Verwendung von add()

js
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

Siehe auch