Atomics.waitAsync()

语法

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()