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.
Atomics.or()
静态方法会将给定的值与数组指定位置上的值进行按位或运算,并返回该位置的旧值。此原子操作保证在修改后的值写回之前不会发生其他写操作。
尝试一下
// 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
语法
js
Atomics.or(typedArray, index, value)
参数
typedArray
-
一个整数类型数组。
Int8Array
、Uint8Array
、Int16Array
、Uint16Array
、Int32Array
、Uint32Array
、BigInt64Array
或BigUint64Array
之一。 index
-
typedArray
中要进行按位或运算的位置。 value
-
要进行按位或运算的值。
返回值
给定位置的旧值(typedArray[index]
)。
异常
TypeError
-
如果
typedArray
不是允许的整数类型数组之一,则抛出该异常。 RangeError
-
如果
index
超出typedArray
的范围,则抛出该异常。
描述
当 a
或 b
为 1 时,按位或运算结果为 1。或运算的真值表如下:
a |
b |
a | b |
---|---|---|
0 | 0 | 0 |
0 | 1 | 1 |
1 | 0 | 1 |
1 | 1 | 1 |
例如, 5 | 1
按位或运算的结果是 0101
,也就是十进制的 5:
5 0101 1 0001 ---- 5 0101
示例
使用 or()
js
const sab = new SharedArrayBuffer(1024);
const ta = new Uint8Array(sab);
ta[0] = 2;
Atomics.or(ta, 0, 1); // 返回 2,即旧的值
Atomics.load(ta, 0); // 3
规范
Specification |
---|
ECMAScript® 2025 Language Specification # sec-atomics.or |