Atomics.wait()

语法

Atomics.wait(typedArray, index, value)
Atomics.wait(typedArray, index, value, timeout)

参数

typedArray

一个查看 SharedArrayBuffer 的 Int32Array 或 BigInt64Array。

index

在 typedArray 中等待的位置。

value

要测试的预期值。

timeout 可选

等待时间（毫秒）。NaN（以及会被转换为 NaN 的值，例如 undefined）将变为 Infinity。负值将变为 0。

返回值

一个字符串，可以是 "not-equal"、"ok" 或 "timed-out"。

• 如果初始 value 不等于 index 处存储的值，则立即返回 "not-equal"。
• 如果被 Atomics.notify() 调用唤醒，则返回 "ok"，无论预期值是否已更改。
• 如果在等待休眠期间，未被 Atomics.notify() 唤醒就超过了指定的 timeout，则返回 "timed-out"。

异常

TypeError

在以下情况之一中抛出

• 如果 typedArray 不是一个查看 SharedArrayBuffer 的 Int32Array 或 BigInt64Array。
• 如果当前线程不能被阻塞（例如，因为它就是主线程）。

RangeError

如果 index 在 typedArray 中超出界限，则抛出。

示例

使用 wait()

给定一个共享的 Int32Array

const sab = new SharedArrayBuffer(1024);
const int32 = new Int32Array(sab);

读取线程正在休眠，并在位置 0 上等待，因为提供的 value 与在提供的 index 处存储的值匹配。读取线程将不会继续执行，直到写入线程调用了在提供的 typedArray 的位置 0 上的 Atomics.notify()。请注意，如果在被唤醒后，写入线程没有改变位置 0 的值，读取线程将不会重新进入休眠，而是会继续执行。

Atomics.wait(int32, 0, 0);
console.log(int32[0]); // 123

写入线程存储一个新值，并在写入后通知等待线程

console.log(int32[0]); // 0;
Atomics.store(int32, 0, 123);
Atomics.notify(int32, 0, 1);

规范

浏览器兼容性

另见

• Atomics
• Atomics.waitAsync()
• Atomics.notify()