本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年11月15日(土)更新: 2026年11月9日(月)約6分で読めます

Atomics.waitAsyncでメインスレッドを止めずに待つ

Atomics.waitAsyncは、共有メモリの値がnotifyで通知されるのをPromiseで待ちます。スレッドを止めないので、メインスレッドでもWorkerからの通知を待てます。Baseline 2025で使えます。

Newly availableAtomics.waitAsync()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になります。

main.js
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
  });
}

ページを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引数:タイムアウトのミリ秒。省略できる
ts
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以降を含めると同じ形の型が付きます。

ts
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"になります。

ts
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を使います。