大网数据广告活动
Web 标准与前端开发

Atomics.waitAsync()

· 52CE 我爱测

**`Atomics.waitAsync()`** 静态方法异步等待共享内存的特定位置并返回一个 Promise。

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。

返回值

一个 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。