Atomics.waitAsync()
Atomics.waitAsync() 静态方法会验证共享内存位置是否包含给定值。如果内存位置与给定值不匹配，它会立即返回一个 value 属性为字符串 "not-equal" 的对象；如果设置的超时时间为零，则返回一个 value 属性为字符串 "timed-out" 的对象。否则，该方法会返回一个对象，其 value 属性是一个 Promise，当调用 Atomics.notify() 时，该 Promise 会以 "ok" fulfilled，或者在超时到期时以 "timed-out" fulfilled。
Atomics.waitAsync() 和 Atomics.notify() 一起使用，以共享内存中的值为基础实现线程同步。如果同步值已更改，线程可以立即继续执行；或者，当线程到达同步点时，它可以等待来自另一个线程的通知。
此方法仅适用于查看 SharedArrayBuffer 的 Int32Array 或 BigInt64Array。它是非阻塞的，并且与 Atomics.wait() 不同，可以在主线程上使用。由于它不会阻塞整个线程，因此您仍然需要小心，不要在 Promise 结算之前访问共享内存。
语法
Atomics.waitAsync(typedArray, index, value)
Atomics.waitAsync(typedArray, index, value, timeout)
参数
typedArray-
一个查看
SharedArrayBuffer的Int32Array或BigInt64Array。 index-
在
typedArray中等待的位置。 value-
要测试的预期值。
timeout可选-
等待时间（以毫秒为单位）。
NaN（以及转换为NaN的值，例如undefined）将变为Infinity。负值将变为0。
返回值
一个具有以下属性的 Object。
异常
TypeError-
如果
typedArray不是查看SharedArrayBuffer的Int32Array或BigInt64Array，则会抛出此异常。 RangeError-
如果
index在typedArray中超出界限，则抛出。
示例
使用 waitAsync()
给定一个共享的 Int32Array。
const sab = new SharedArrayBuffer(1024);
const int32 = new Int32Array(sab);
一个读取线程正在睡眠，并等待位置 0，预期该位置的值为 0。result.value 将是一个 Promise。
const result = Atomics.waitAsync(int32, 0, 0, 1000);
// { async: true, value: Promise {<pending>} }
在读取线程或另一个线程中，调用内存位置 0，并且 Promise 可以以 "ok" 解析。
Atomics.notify(int32, 0);
// { async: true, value: Promise {<fulfilled>: 'ok'} }
如果它没有解析为 "ok"，则共享内存位置中的值不是预期的值（value 将是 "not-equal" 而不是 Promise），或者已达到超时时间（Promise 将解析为 "time-out"）。
规范
| 规范 |
|---|
| ECMAScript® 2026 语言规范 # sec-atomics.waitasync |
浏览器兼容性
加载中…