Atomics.notify()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年12月以降、すべてのブラウザーで利用可能です。

Atomics.notify() は静的メソッドで、待ち行列で休眠状態にあるエージェントに通知します。

メモ: この操作は SharedArrayBuffer のビューである Int32Array または BigInt64Array に対してのみ動作します。共有されていない ArrayBuffer オブジェクトでは 0 を返します。

構文

Atomics.notify(typedArray, index, count)

引数

typedArray

SharedArrayBuffer のビューである Int32Array または BigInt64Array。

index

起動する対象となる typedArray 中の位置。

count 省略可

通知する休眠状態のエージェントの数。既定値は Infinity です。

返値

覚醒したエージェントの数を返します。この typedArray が共有されていない ArrayBuffer のビューである場合は 0 を返します。

例外

TypeError

この typedArray が Int32Array または BigInt64Array のどちらでもない場合に発生します。

RangeError

index が typedArray の範囲を超えている場合に発生します。

例

notify の使用

共有された Int32Array を用意します。

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

指定された value が指定された index に格納されている値と一致するため、読み取りスレッドは位置 0 で休眠状態で待機しています。書き込みスレッドが、指定された typedArray の位置 0 で Atomics.notify() を呼び出すまで、読み取りスレッドは移動しません。覚醒した後、位置 0 の値が書き込みスレッドによって変更されていない場合、読み取りスレッドは休眠状態に戻らず、処理を続行することに注意してください。

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

書き手のスレッドは新しい値を格納し、待機中のスレッドに通知を行います。

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

仕様書

ECMAScript® 2027 Language Specification
# sec-atomics.notify

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年7月25日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

Atomics.notify()

目次

構文

引数

返値

例外

例

notify の使用

仕様書

ブラウザーの互換性

関連情報

MDN の改良に協力