ReactとWeb Locksで複数タブの同時実行を防ぐ方法
同じ Web アプリを複数のタブで開くと、データの同期や、サーバーへの定期的な問い合わせが、タブの数だけ同時に走ることがあります。ブラウザの Web Locks API を使うと、タブどうしの排他制御ができます。あるタブが名前を付けたロックを持っている間、同じオリジンのほかのタブは、同じ名前のロックを取れません。
ここでは、処理を1つずつ順番に動かす関数 runExclusive と、担当のタブを1つだけ決めるフック useLeaderLock を作り、3つのタブで動きを確かめました。
検証環境は Ubuntu 24.04、Node.js 22.23.4 です。使ったのは React 19.3.1、TypeScript 7.0.2、esbuild 0.28.2 です。tsc で型チェックしてから esbuild の開発用ビルドで変換し、<StrictMode> で包んで動かしました。タブは、Playwright 1.63.0 で Chromium 153 の同じブラウザコンテキストにページを3つ開いて作っています。Firefox と Safari、Web Worker や Service Worker からロックを使う場合、mode: 'shared' と steal は試していません。
どのブラウザで使えるか
MDN の互換性データでは、LockManager は Chrome 69、Edge 79、Firefox 96、Safari 15.4 から使えます。Android 版の Chrome と iOS 版の Safari も、それぞれ 69 と 15.4 からです。
MDN の navigator.locks の説明にあるとおり、navigator.locks は安全なコンテキスト(secure context)でだけ使えます。検証環境で http://localhost から開いたページでは、isSecureContext も 'locks' in navigator も true でした。
ロックはオリジンごとに分かれています。https://example.com のタブが取ったロックは、https://example.org:8080 のタブには関係しません。検証環境では、Playwright で別のブラウザコンテキストに開いたタブとは、ロックは共有されませんでした。
同期を1つずつ順番に動かす
基本の形は、navigator.locks.request() にロックの名前と関数を渡すものです。ロックが取れると関数が呼ばれ、関数が返した Promise が終わると、ロックは自動で手放されます。その間、同じ名前で request() したほかのタブは、順番待ちになります。
// runExclusive.ts
// name のロックを取ってから task を動かす。
// ifAvailable が true のときは、ほかのタブが動かしている最中なら何もしない。
export async function runExclusive<T>(
name: string,
task: () => Promise<T>,
{ ifAvailable = false } = {},
): Promise<{ ran: true; value: T } | { ran: false }> {
return navigator.locks.request(name, { ifAvailable }, async (lock) => {
if (lock === null) return { ran: false }; // 取れなかった
return { ran: true, value: await task() };
});
}
request() は、渡した関数の戻り値で解決する Promise を返します。検証環境で navigator.locks.request('job', () => 42) を await すると、42 が返りました。そこで runExclusive では、task の結果をそのまま呼び出し元へ返しています。
React のボタンからは、ふつうの非同期関数として呼びます。sync() は /sync に fetch する関数です(検証で使ったコードでは、どのタブ・どのボタンからの呼び出しかを URL に付けています)。
<button
onClick={async () => {
const r = await runExclusive('sync', () => sync());
if (r.ran) setLog(`終了:同時に${r.value.running}件`);
}}
>
順番に同期
</button>
検証用のサーバーには、1秒かかる /sync を用意しました。サーバーは、その1秒の間に同時に動いていた /sync の数の最大値を返します。3つのタブで同時にボタンを押して、ロックなしの場合と比べました。

ロックなしでは、3つのタブの /sync が同じ時刻に始まり、どのタブにも「同時に3件」と返りました。runExclusive を通すと、1つ目が終わった時刻に次が始まり、3つが約1秒ずつずれて走りました。どのタブも「同時に1件」です。押してから0.4秒後に navigator.locks.query() で調べると、sync のロックは1つが取られていて(held)、2つが待ち(pending)になっていました。
MDN の説明では、待っているリクエストは列に並び、ロックが手放されると先頭のものに渡されます。この検証では、タブの並び(A、B、C)とは違い、タブ A、タブ C、タブ B の順に動きました。
ほかのタブが動かしていたら、やめる
同期の結果がどのタブにも共有されるなら、1つのタブがやれば十分です。待たずにやめたほうが無駄がありません。ifAvailable: true を付けると、ロックがすぐに取れないときは、関数が null を受け取って呼ばれます。
const r = await runExclusive('sync', () => sync(), { ifAvailable: true });
setLog(r.ran ? `終了:同時に${r.value.running}件` : 'ほかのタブが同期中なので、やめた');
3つのタブで同時に押すと、/sync は1回だけ動きました。そのタブには「同時に1件」と出て、残りの2つのタブには「ほかのタブが同期中なので、やめた」と出ました。
ifAvailable と、待つのをやめるための signal は一緒に渡せません。検証環境で両方を渡すと、NotSupportedError(「The 'signal' and 'ifAvailable' options cannot be used together.」)になりました。MDN の request() の説明にも、この組み合わせは NotSupportedError になると書かれています。
渡した関数の中で例外が起きたときも、ロックは手放されました。request() は、その例外で reject されます。その直後に query() で調べると held は空で、同じ名前を ifAvailable: true で取り直すことができました。
担当のタブを1つだけ決めるフック
通知の取得のように、画面を開いている間ずっと続く処理もあります。これを1つのタブにだけ任せたいときは、ロックを取ったまま手放さないようにします。MDN の Web Locks API の説明にある、関数から自分で解決する Promise を返す書き方です。ロックを持っているタブが「担当」で、ほかのタブは待ちの列に並んだまま、担当が抜けるのを待ちます。
// useLeaderLock.ts
import { useEffect, useState } from 'react';
// name のロックを、このコンポーネントが画面にある間ずっと持ち続ける。
// ほかのタブが持っているときは、空くまで待つ。
export function useLeaderLock(name: string): boolean {
const [isLeader, setIsLeader] = useState(false);
useEffect(() => {
if (!('locks' in navigator)) return;
const controller = new AbortController();
let release = () => {};
navigator.locks
.request(name, { signal: controller.signal }, () => {
setIsLeader(true);
// この Promise が解決するまで、ロックは手放されない
return new Promise<void>((resolve) => {
release = resolve;
});
})
.catch((error) => {
// 待っている間に画面から消えたときは AbortError になる
if (error.name !== 'AbortError') throw error;
});
return () => {
controller.abort(); // まだ待っているなら、待つのをやめる
release(); // 持っているなら、手放す
setIsLeader(false);
};
}, [name]);
return isLeader;
}
クリーンアップ関数では、2つのことをしています。まだ順番待ちのときは、AbortController の abort() で待ちの列から外れます。MDN の request() の説明のとおり、まだロックが渡されていない待ちは取り消され、request() は AbortError で reject されます。すでにロックを持っているときは、release() で Promise を解決して手放します。
フックを使う側では、isLeader が true のタブだけが、1秒ごとにサーバーへ問い合わせます。
function Leader() {
const isLeader = useLeaderLock('poller');
// 担当のタブだけが、1秒ごとにサーバーへ問い合わせる
useEffect(() => {
if (!isLeader) return;
const id = setInterval(() => {
fetch('/poll');
}, 1000);
return () => clearInterval(id);
}, [isLeader]);
return <p>{isLeader ? 'このタブが通知の取得を担当' : 'ほかのタブが担当中(待機)'}</p>;
}
検証で使ったコードでは、どのタブからの問い合わせかが分かるように、/poll の URL にタブの名前を付けています。
担当のタブがいなくなると、次のタブに移る
3つのタブを開くと、最初に開いたタブ A だけが担当になりました。サーバーに届いた /poll は、1秒ごとにタブ A からの1件ずつです。タブ A を閉じると、その後の /poll はタブ B から1秒ごとに届くようになりました。タブ B とタブ C から同時に届くことはありませんでした。
担当が移るのは、タブを閉じたときだけではありませんでした。3つのタブを開き直し、担当のタブに次の操作を順にしたところ、どの場合も、列の先頭で待っていたタブが担当になりました。
| 担当のタブでしたこと | その後 |
|---|---|
| タブ A で、フックを使うコンポーネントを画面から消した | タブ B が担当になった。query() の held はタブ B の1件、pending はタブ C の1件 |
| タブ B のページを再読み込みした | タブ C が担当になり、読み込み直したタブ B は待ちの列に並んだ |
| タブ C を閉じた | タブ A が担当になった |
1行目の後で、タブ A のコンポーネントをもう一度画面に出しています。タブ A は担当に戻らず、待ちの列の最後に並びました。そのため、3行目でタブ A が列の先頭になっています。
<StrictMode> の開発用ビルドでは、React はエフェクトのセットアップとクリーンアップを、最初に1回余分に実行します(公式リファレンスの StrictMode の説明)。それでも、3つのタブを開いた直後の query() は、held が1件、pending が2件でした。後で示すクリーンアップを書かない版では、同じ条件で pending が5件になりました。この差は、完成形では1回目のセットアップで出したロックの要求が、クリーンアップの abort() で取り消されているためです。
クリーンアップを書かないと、ロックが手放されない
比べるために、クリーンアップ関数を返さない版も作りました。
// クリーンアップ関数を返さない版(このように書かない)
useEffect(() => {
navigator.locks.request(name, () => {
setIsLeader(true);
return new Promise<void>(() => {}); // 手放さない
});
}, [name]);
この版で3つのタブを開くと、query() の pending は5件になりました。query() の結果に含まれる、要求を出したタブを表す clientId を見ると、タブ B とタブ C からは2件ずつ、担当のタブ A からも1件の要求が待っていました。<StrictMode> で余分に実行されたセットアップのロックの要求が、取り消されずに残っています。タブ A は、自分が持っているロックを自分で待っている状態です。
この状態でタブ A のコンポーネントを画面から消すと、タブ B とタブ C は待ったままで、どのタブも担当になりませんでした。コンポーネントが消えても、ロックはタブ A が持ったままだからです。もう一度コンポーネントを出しても、タブ A は担当になりません。新しく出したコンポーネントのフックは、待ちの列に並び直すだけでした。
別に、タブを2つ(A と B)だけ開いて、タブ A でコンポーネントを消してからタブ A を閉じることも試しました。コンポーネントを消した後もタブ B は待ったままで、タブ A を閉じて0.3秒後には、タブ B が担当になっていました。
ロックを持ち続けるフックでは、クリーンアップ関数で、待ちの取り消し(abort())と、持っているロックを手放すこと(Promise の解決)の両方をします。





