Atomics.or()
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.or()
führt ein bitweises OR mit einem angegebenen Wert an einer bestimmten Position im Array durch und gibt den alten Wert an dieser Position zurück. Diese atomare Operation garantiert, dass kein anderer Schreibvorgang stattfindet, bis der modifizierte Wert zurückgeschrieben wird.
Probieren Sie es aus
// Create a SharedArrayBuffer with a size in bytes
const buffer = new SharedArrayBuffer(16);
const uint8 = new Uint8Array(buffer);
uint8[0] = 5;
// 5 (0101) OR 2 (0010) = 7 (0111)
console.log(Atomics.or(uint8, 0, 2));
// Expected output: 5
console.log(Atomics.load(uint8, 0));
// Expected output: 7
Syntax
Atomics.or(typedArray, index, value)
Parameter
typedArray
-
Ein ganzzahliges typisiertes Array. Einer von
Int8Array
,Uint8Array
,Int16Array
,Uint16Array
,Int32Array
,Uint32Array
,BigInt64Array
, oderBigUint64Array
. index
-
Die Position im
typedArray
, an der das bitweise OR berechnet werden soll. value
-
Die Zahl, mit der das bitweise OR berechnet 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.
Beschreibung
Die bitweise OR-Operation ergibt 1, wenn entweder a
oder b
1 sind. Die Wahrheitstabelle für die OR-Operation ist:
a |
b |
a | b |
---|---|---|
0 | 0 | 0 |
0 | 1 | 1 |
1 | 0 | 1 |
1 | 1 | 1 |
Zum Beispiel ergibt ein bitweises OR von 5 | 1
0101
, was dezimal 5 ist.
5 0101 1 0001 ---- 5 0101
Beispiele
Verwendung von or
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
ta[0] = 2;
Atomics.or(ta, 0, 1); // returns 2, the old value
Atomics.load(ta, 0); // 3
Spezifikationen
Specification |
---|
ECMAScript® 2026 Language Specification # sec-atomics.or |