Atomics.waitAsync() 静态方法异步等待共享内存的特定位置并返回一个 Promise。
与 Atomics.wait() 不同,waitAsync 是非阻塞的且可用于主线程。
[!NOTE] 此操作仅适用于基于 SharedArrayBuffer 的 Int32Array 或 BigInt64Array 视图。
语法
Atomics.waitAsync(typedArray, index, value)
Atomics.waitAsync(typedArray, index, value, timeout)
参数
typedArray- : 基于 SharedArrayBuffer 的 Int32Array 或 BigInt64Array。
index- :
typedArray中要等待的位置。
- :
value- : 要测试的期望值。
timeout- : 等待时间,以毫秒为单位。NaN(以及会被转换为
NaN的值,例如undefined)会被转换为 Infinity。负值会被转换为0。
- : 等待时间,以毫秒为单位。NaN(以及会被转换为
返回值
一个 Object,包含以下属性:
async- : 一个布尔值,指示
value属性是否为 Promise。
- : 一个布尔值,指示
value- : 如果
async是false,它将是一个内容为"not-equal"或"timed-out"的字符串(仅当timeout参数为0时)。如果async是true,它将会是一个 Promise,其兑现值为一个内容为"ok"或"timed-out"的字符串。这个 promise 永远不会被拒绝。
- : 如果
异常
- 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")。
规范
浏览器兼容性
参见
- Atomics
- Atomics.wait()
- Atomics.notify()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
