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 の場合、 "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 はプロミスになります。

const result = Atomics.waitAsync(int32, 0, 0, 1000);
// { async: true, value: Promise {<pending>} }

読み込みスレッドまたは別のスレッドで、メモリー位置 0 が呼び出され、プロミスは "ok" で解決できます。

Atomics.notify(int32, 0);
// { async: true, value: Promise {<fulfilled>: 'ok'} }

"ok" に解決されない場合、共有メモリーの場所の値が期待した値ではなかったか（value はプロミスではなく "not-equal" になります）、タイムアウトに達したということです（プロミスは "time-out" に解決されます）。

仕様書

ブラウザーの互換性

関連情報

• Atomics
• Atomics.wait()
• Atomics.notify()