Atomics.exchange()

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.exchange() tauscht einen gegebenen Wert an einer bestimmten Position im Array aus und gibt den alten Wert an dieser Position zurück. Diese atomare Operation garantiert, dass zwischen dem Auslesen des alten Wertes und dem Schreiben des neuen Wertes keine anderen Schreibvorgänge stattfinden.

Probieren Sie es aus

Syntax

Atomics.exchange(typedArray, index, value)

Parameter

typedArray: Ein Integer-Typed-Array. Eines von Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array oder BigUint64Array.
index: Die Position im typedArray, an der ein value ausgetauscht werden soll.
value: Die Zahl, die ausgetauscht werden soll.

Rückgabewert

Der alte Wert an der angegebenen Position (typedArray[index]).

Ausnahmen

TypeError: Wird ausgelöst, wenn typedArray nicht einer der erlaubten Integer-Typen ist.
RangeError: Wird ausgelöst, wenn index außerhalb der Grenzen des typedArray liegt.

Beispiele

Verwendung von exchange()

const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);

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

Spezifikationen

Specification
ECMAScript® 2025 Language Specification # sec-atomics.exchange

Browser-Kompatibilität

BCD tables only load in the browser