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