Atomics.compareExchange()

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.compareExchange() tauscht einen gegebenen Ersatzwert an einer bestimmten Position im Array aus, wenn ein gegebener erwarteter Wert dem alten Wert entspricht. Sie gibt den alten Wert an dieser Position zurück, unabhängig davon, ob er dem erwarteten Wert entsprach oder nicht. Diese atomare Operation garantiert, dass keine andere Schreiboperation erfolgt, bis der geänderte Wert zurückgeschrieben wurde.

Probieren Sie es aus

Syntax

js
Atomics.compareExchange(typedArray, index, expectedValue, replacementValue)

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

expectedValue

Der Wert, um auf Gleichheit zu prüfen.

replacementValue

Die Zahl, die ausgetauscht werden soll.

Rückgabewert

Der alte Wert an der angegebenen Position (typedArray[index]). Wenn der Rückgabewert dem expectedValue entspricht, war der Austausch erfolgreich; andernfalls ist der Austausch fehlgeschlagen.

Ausnahmen

TypeError

Wird ausgelöst, wenn typedArray nicht einer der erlaubten Ganzzahltypen ist.

RangeError

Wird ausgelöst, wenn index außerhalb der Grenzen im typedArray liegt.

Beispiele

Verwendung von compareExchange()

js
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
ta[0] = 7;

Atomics.compareExchange(ta, 0, 7, 12); // returns 7, the old value
Atomics.load(ta, 0); // 12

Überprüfen des Rückgabewerts

Das Compare-and-swap garantiert, dass der neue Wert auf Basis aktueller Informationen berechnet wird; wenn der Wert in der Zwischenzeit von einem anderen Thread aktualisiert wurde, würde das Schreiben scheitern. Daher sollten Sie den Rückgabewert von compareExchange() überprüfen, um festzustellen, ob es fehlgeschlagen ist, und bei Bedarf erneut versuchen.

Hier ist ein Beispiel eines atomaren Addierers (gleiche Funktionalität wie Atomics.add()), adaptiert aus dem verlinkten Wikipedia-Artikel:

js
function add(mem, index, value) {
  let done = false;
  while (!done) {
    const value = Atomics.load(mem, index);
    done = Atomics.compareExchange(p, value, value + a) === value;
  }
  return value + a;
}

Es liest zunächst den Wert an dem angegebenen Index und versucht dann, ihn mit dem neuen Wert zu aktualisieren. Es versucht es immer wieder, bis es erfolgreich den Wert aktualisiert.

Spezifikationen

Specification
ECMAScript Language Specification
# sec-atomics.compareexchange

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch