Atomics.wait()
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.wait() 静态方法验证共享内存特定位置是否仍然包含给定值，如果是则休眠，直到被唤醒或超时。其返回一个内容为 "ok"、"not-equal" 或 "timed-out" 的字符串。
备注：
此操作仅适用于基于 SharedArrayBuffer 的 Int32Array 或 BigInt64Array 视图，并且在主线程中可能不可用。有关此方法的非阻塞异步版本，请参见 Atomics.waitAsync()。
语法
js
Atomics.wait(typedArray, index, value)
Atomics.wait(typedArray, index, value, timeout)
参数
typedArray-
基于
SharedArrayBuffer的Int32Array或BigInt64Array。 index-
typedArray中要等待的位置。 value-
要测试的期望值。
timeout可选-
等待时间，以毫秒为单位。
NaN（以及会被转换为NaN的值，例如undefined）会被转换为Infinity。负值会被转换为0。
返回值
一个内容为 "ok"、"not-equal" 或 "timed-out" 的字符串。
异常
TypeError-
有下列情况之一，则抛出该异常：
- 如果
typedArray不是一个基于SharedArrayBuffer的Int32Array或BigInt64Array。 - 如果当前线程无法被阻塞（例如主线程）。
- 如果
RangeError-
如果
index超出typedArray的范围，则抛出该异常。
示例
使用 wait()
给定一个共享的 Int32Array：
js
const sab = new SharedArrayBuffer(1024);
const int32 = new Int32Array(sab);
令一个读取线程休眠并在位置 0 处等待，预期该位置的值为 0。只要条件一直为真，则将不会继续运行。然而，一旦写入线程存储了一个新的值，它将被读取线程唤醒并返回新的值（123）。
js
Atomics.wait(int32, 0, 0);
console.log(int32[0]); // 123
写入线程存储一个新的值并在写入后唤醒等待的线程：
js
console.log(int32[0]); // 0;
Atomics.store(int32, 0, 123);
Atomics.notify(int32, 0, 1);
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-atomics.wait |