Die statische Atomics.compareExchange() Methode ersetzt einen Wert an einer gegebenen Position im einem Array mit einem gegebene Wert aus, wenn ein gegebenen Wert gleich dem alten Wert ist. Es wird der alte Wert an der Position zurückgegeben, egal ob der abzugleichende Wert gleich oder nicht ist. Die atomare Operation garantiert, dass kein anderer Schreibprozess während der Operation durchgeführt wird.

Syntax

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

Parameter

typedArray
Ein geteiltes getrypted Integer Array. Eines von Int8Array, Uint8Array, Int16Array, Uint16Array, Int32Array oder Uint32Array.
index
Die Position in typedArray, an den ein Wert ersetzt wird.
expectedValue
Wert, auf dem die gleichheit geprüft wird.
replacementValue
Neu Zahl, die geschreiben wird.

Rückgabewert

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

Exceptions

  • Erzeugt einen TypeError, wenn typedArray nicht von einem erlaubten Integer Typ ist.
  • Erzeugt eine TypeError, wenn typedArray kein geteilter Arraytyp ist.
  • Erzeugt ein RangeError, wenn der index nicht in den Grenzen von typedArray ist.

Beispiele

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

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

Spezifikationen

Spezifikation Status Kommentar
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Atomics.compareExchange' in dieser Spezifikation.
Entwurf Initiale Definition in ES2017.

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidEdge MobileFirefox für AndroidOpera für AndroidiOS SafariSamsung InternetNode.js
Grundlegende UnterstützungChrome Vollständige Unterstützung 68
Vollständige Unterstützung 68
Keine Unterstützung 60 — 63
Hinweise
Hinweise Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This was a temporary removal while mitigations were put in place.
Edge Vollständige Unterstützung 16
Hinweise
Vollständige Unterstützung 16
Hinweise
Hinweise Support was removed to mitigate speculative execution side-channel attacks (Windows blog).
Firefox Vollständige Unterstützung 57
Hinweise Deaktiviert
Vollständige Unterstützung 57
Hinweise Deaktiviert
Hinweise Support was disabled by default to mitigate speculative execution side-channel attacks (Mozilla Security Blog).
Deaktiviert From version 57: this feature is behind the javascript.options.shared_memory preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Keine Unterstützung 55 — 57
Keine Unterstützung 46 — 55
Deaktiviert
Deaktiviert From version 46 until version 55 (exclusive): this feature is behind the javascript.options.shared_memory preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE Keine Unterstützung NeinOpera Keine Unterstützung NeinSafari Keine Unterstützung 10.1 — ?WebView Android Keine Unterstützung 60 — 63
Hinweise
Keine Unterstützung 60 — 63
Hinweise
Hinweise Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This is intended as a temporary measure until other mitigations are in place.
Chrome Android Keine Unterstützung 60 — 63
Hinweise
Keine Unterstützung 60 — 63
Hinweise
Hinweise Chrome disabled SharedArrayBuffer on January 5, 2018 to help reduce the efficacy of speculative side-channel attacks. This is intended as a temporary measure until other mitigations are in place.
Edge Mobile ? Firefox Android Vollständige Unterstützung 57
Hinweise Deaktiviert
Vollständige Unterstützung 57
Hinweise Deaktiviert
Hinweise Support was disabled by default to mitigate speculative execution side-channel attacks (Mozilla Security Blog).
Deaktiviert From version 57: this feature is behind the javascript.options.shared_memory preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Keine Unterstützung 55 — 57
Keine Unterstützung 46 — 55
Deaktiviert
Deaktiviert From version 46 until version 55 (exclusive): this feature is behind the javascript.options.shared_memory preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Keine Unterstützung NeinSafari iOS Keine Unterstützung NeinSamsung Internet Android Keine Unterstützung Neinnodejs Vollständige Unterstützung 8.10.0

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Keine Unterstützung  
Keine Unterstützung
Kompatibilität unbekannt  
Kompatibilität unbekannt
Siehe Implementierungshinweise.
Siehe Implementierungshinweise.
Benutzer muss dieses Feature explizit aktivieren.
Benutzer muss dieses Feature explizit aktivieren.

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Mitwirkende an dieser Seite: schlagi123
Zuletzt aktualisiert von: schlagi123,