此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

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 ⁨2021年12月⁩.

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

一个整数类型数组。Int8ArrayUint8ArrayInt16ArrayUint16ArrayInt32ArrayUint32ArrayBigInt64ArrayBigUint64Array 之一。

index

typedArray 中要进行按位或运算的位置。

value

要进行按位或运算的值。

返回值

给定位置的旧值(typedArray[index])。

异常

TypeError

如果 typedArray 不是允许的整数类型数组之一,则抛出该异常。

RangeError

如果 index 超出 typedArray 的范围,则抛出该异常。

描述

ab 为 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® 2026 Language Specification
# sec-atomics.or

浏览器兼容性

参见