Atomics.waitAsyncでメインスレッドを止めずに待つ
Atomics.waitAsyncは、共有メモリの値がnotifyで通知されるのをPromiseで待ちます。スレッドを止めないので、メインスレッドでもWorkerからの通知を待てます。Baseline 2025で使えます。
- Chrome90
- Edge90
- Firefox145
- Safari16.4
はじめに
Atomics.waitAsyncは、SharedArrayBufferの値がnotifyで通知されるのを、スレッドを止めずにPromiseで待つ静的メソッドです。Atomics.waitの非同期版です。Firefox 145が対応して、Baseline 2025に入りました。
Workerの計算結果は、WorkerがpostMessageで送り、メインスレッドがmessageイベントで受け取ります。Workerと共有したメモリの値が書き換わるのを待つときに、Atomics.waitAsyncが要ります。Atomics.waitはスレッドを止めて待つので、ブラウザのメインスレッドで呼ぶとTypeErrorになります。
const int32 = new Int32Array(new SharedArrayBuffer(4));
const result = Atomics.waitAsync(int32, 0, 0);
const worker = new Worker('worker.js');
worker.postMessage(int32);
if (result.async) {
result.value.then((value) => {
console.log(value, Atomics.load(int32, 0)); // ok 42
});
}onmessage = ({ data: int32 }) => {
Atomics.store(int32, 0, 42);
Atomics.notify(int32, 0);
};ページをCross-Origin-Opener-Policy: same-originとCross-Origin-Embedder-Policy: require-corpのヘッダーで返し、main.jsを読み込むと、コンソールにok 42が出ます。どのブラウザでも、待っているあいだもメインスレッドのタイマーは動き続けます。
Atomicsの基本とAtomics.pauseは、AtomicsでWorker間の共有メモリを安全に読み書きするで書いています。
引数と戻り値
waitAsyncは4つの引数を取ります。
- 第1引数:
SharedArrayBufferを元にしたInt32ArrayかBigInt64Array - 第2引数:その配列のインデックス
- 第3引数:その位置にあると期待する値
- 第4引数:タイムアウトのミリ秒。省略できる
const sab = new SharedArrayBuffer(4);
const int32 = new Int32Array(sab);
// int32の0番目の値が0であることを期待して待機、タイムアウトは1秒
const result = Atomics.waitAsync(int32, 0, 0, 1000);戻り値はPromiseではなく、すぐに返るオブジェクトです。asyncはvalueがPromiseかどうかを、valueは待った結果を表します。
戻り値の型は次のとおりです。TypeScriptでは、libにes2024以降を含めると同じ形の型が付きます。
type ReturnValue =
| { async: false; value: "not-equal" | "timed-out" }
| { async: true; value: Promise<"ok" | "timed-out"> };{ async: false; value: "not-equal" }は、その位置の値が第3引数と違っていたときに返ります。Workerが値を書き換えてから呼ぶと、どのブラウザでも{ async: false, value: 'not-equal' }が返ります。冒頭のmain.jsでwaitAsyncをpostMessageより先に呼んでいるのは、このためです。
{ async: false; value: "timed-out" }は、タイムアウトに0ミリ秒を渡したときに返ります。
ふだん返るのは{ async: true; value: Promise<"ok" | "timed-out"> }です。valueのPromiseは、notifyで起こされると"ok"に、その前にタイムアウトすると"timed-out"になります。
const sab = new SharedArrayBuffer(4);
const int32 = new Int32Array(sab);
const result = Atomics.waitAsync(int32, 0, 0, 1000);
if (result.value === 'not-equal') {
// 指定した位置に存在する値が期待した値と異なる場合の処理
}
if (result.value === 'timed-out') {
// タイムアウト時間が0ミリ秒に指定された場合の処理
}
if (result.async) {
result.value.then(
(value) => {
if (value === 'ok') {
// notifyによって呼び出された場合の処理
} else {
// タイムアウトした場合の処理
}
});
}共有していない配列を渡すなど引数が不正なときは、呼び出した時点でTypeErrorが投げられます。valueのPromiseがrejectされることはありません。
Node.jsでは、waitAsyncのPromiseだけが残るとプロセスが終わり、タイムアウトを100msにしてもthenは呼ばれません。Node.jsで使うときは、Workerのようにプロセスを動かし続けるものと組み合わせます。
おわりに
Atomics.waitAsyncはスレッドを止めずにnotifyを待つので、メインスレッドでもWorkerが共有メモリを書き換えるのを待てます。Workerが先に書き換えたときはnot-equalがすぐに返るので、asyncを確かめてからvalueを使います。