Atomics.waitAsync()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Atomics.waitAsync()
静态方法异步等待共享内存的特定位置并返回一个 Promise
。
与 Atomics.wait()
不同,waitAsync
是非阻塞的且可用于主线程。
备注:
此操作仅适用于基于 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
。
返回值
异常
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"
)。
规范
Specification |
---|
ECMAScript Language Specification # sec-atomics.waitasync |
浏览器兼容性
BCD tables only load in the browser