Atomics.notify()
静的メソッドである Atomics
.notify()
は、待ち行列で休眠状態にあるいくつかのエージェントに通知します。
注: この操作は共有された Int32Array
に対してのみ許可されています。
共有されていない ArrayBuffer
オブジェクトでは 0
を返します。
構文
Atomics.notify(typedArray, index, count)
引数
typedArray
- 共有された
Int32Array
。 index
- 起動する対象となる
typedArray
中の位置。 count
- 起動するエージェントの数。既定値は
+Infinity
です。
返値
- 起動したエージェントの数を返します。
- 共有されていない
ArrayBuffer
オブジェクトが使用された場合は、0
を返します。
例外
typedArray
がInt32Array
でない場合、TypeError
が送出される。index
がtypedArray
の範囲を超えている場合RangeError
が送出される。
例
notify
の使用
共有された Int32Array
を用意します:
const sab = new SharedArrayBuffer(1024);
const int32 = new Int32Array(sab);
読み手のスレッドは、0 番目の値が 0 であることを期待してスリープします。それが満たされている間は処理が進みません。しかし、書き手のスレッドが新しい値をストアした場合、読み手のスレッドは読み手のスレッドによって起こされ、新しい値 (123) を取得します。
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);
仕様書
ブラウザーの互換性
BCD tables only load in the browser