【ITニュース解説】`localStorage.clear()` Tells Your Other Tabs Nothing They Are Listening For
2026年10月21日に「Dev.to」が公開したITニュース「`localStorage.clear()` Tells Your Other Tabs Nothing They Are Listening For」について初心者にもわかりやすく解説しています。
ITニュース概要
`localStorage.clear()`でログアウトしても、他のタブはログイン状態のままになることがある。これは、`storage`イベントが変更元タブで発生せず、`clear()`時のイベントはkeyがnullのため、他のタブがログアウトを検知できないことが原因だ。`e.key === null`も考慮したログアウト処理が必要で、複数タブでの動作確認が重要だ。
ITニュース解説
システムを開発する上で、ユーザーの「ログアウト」機能は非常に重要だ。しかし、この機能が特定の状況下で正しく動作しないという、一見すると不可解なバグが発生することがある。具体的には、ユーザーがウェブアプリケーションからログアウトしたはずなのに、同じブラウザで開いている別のタブを見ると、まだログイン状態が維持されている、といった現象だ。開発者はこの問題を再現しようとしても、通常は単一のタブでテストするため、ログアウトは完璧に機能しているように見え、バグを発見できないことが少なくない。
この問題の根源は、ブラウザのいくつかの挙動が組み合わさることで発生する。まず一つ目は、ブラウザの「ストレージイベント(storage event)」の仕組みだ。ウェブアプリケーションでは、ユーザーの認証情報などをブラウザに一時的に保存するために、「localStorage」や「sessionStorage」といったウェブストレージを利用することが一般的である。これらのストレージに何らかの変更があった場合、同じウェブサイト(同じオリジン)の異なるタブ間でその変更を通知し合うために「storage event」が発火する。しかし、ここで重要なのは、このイベントは「変更を行ったタブ自身には発火しない」という仕様である点だ。変更を行ったタブは、すでにその変更を認識しているため、イベントを受け取る必要がないという合理的な設計なのだ。このため、ユーザーがログアウトボタンをクリックしたタブでは、認証情報が削除されたことを認識し、すぐにログアウト状態になる。しかし、別のタブでは、そのストレージの変更を通知するイベントは受け取るものの、変更を行ったのが自分自身ではないため、このタブはイベントを受け取る。だが、ログアウトしたタブ側では問題が起きていないように見えるため、クロス・タブでの問題が開発段階で見過ごされやすい。
二つ目の問題点は、localStorage.clear()というメソッドの挙動にある。ログアウト処理を実装する際、開発者は認証トークンなどの特定の情報を削除するためにlocalStorage.removeItem('auth.token')のようなメソッドを使うことが多い。しかし、より安全策として、セッション終了時にブラウザに保存されている全ての情報を消去しようと、localStorage.clear()というメソッドを呼び出すケースも少なくない。これは、何も情報を残さないという開発者の慎重な姿勢からくるものだ。ところが、HTMLの仕様では、localStorage.clear()が発火する「storage event」には、削除されたキーに関する具体的な情報が含まれないと定められている。このイベントは「null, null, null」という値、つまりキー、古い値、新しい値がすべてnullという形でブロードキャストされる。
一般的なストレージイベントのハンドラ(イベントを受け取って処理する関数)は、e.key === 'auth.token' && e.newValue === nullのように、イベントオブジェクト内のkeyプロパティをチェックして、特定の認証トークンが削除された場合にのみ処理を実行するように記述されていることが多い。しかし、localStorage.clear()によって発火されたイベントではe.keyがnullであるため、このような条件式はfalseとなり、ハンドラは何も処理せずに終了してしまう。その結果、別のタブはストレージの変更イベント自体は受け取るものの、ハンドラが適切に反応しないため、メモリ上にロード時に読み込んだ古い認証トークンを保持したままになる。そして、そのトークンを使って認証済みのリクエストを継続的に送り続け、ログアウトしたはずなのにログイン状態が維持されるという事態に陥るのだ。この状況はエラーを発生させず、エラー追跡システムにも記録されないため、原因の特定が非常に困難になる。
この問題の解決策は、ストレージイベントのハンドラを修正することにある。具体的には、イベントのkeyプロパティがnullである場合を、「全ての情報がクリアされた」と解釈して処理に含める必要がある。例えば、次のようにハンドラを記述する。window.addEventListener('storage', (e) => { const cleared = e.key === null; const tokenRemoved = e.key === 'auth.token' && e.newValue === null; if (cleared || tokenRemoved) { /* セッションをクリアし、ログインページにリダイレクトする処理 */ } });このようにすることで、localStorage.clear()によるイベントと、特定のキーが削除された場合のイベントの両方に対応できるようになる。自分自身のコードでlocalStorage.clear()を使わない場合でも、ページに埋め込まれたサードパーティのスクリプトがこのメソッドを呼び出す可能性があるため、このような対応は非常に重要だ。
なぜこの種の問題が有用な形で報告されにくいかというと、ユーザーの報告内容と実際のバグの発生源が異なるためだ。ユーザーは「ログアウトが機能しない」と報告するが、その報告者が操作していたタブでは既にログアウトが完了している。問題が起きているのは、報告者がその時見ていなかったり、既に閉じてしまったりした「別のタブ」なのだ。ユーザーは、目の前のタブでログアウトが完了していれば、それが通常の状態だと判断し、別のタブの状態をバグの原因として関連付けようとは考えない。そのため、問題の核心が「タブの数」にあることに気づくことは非常に難しく、偶然複数のタブが開かれている状態でネットワーク通信などを監視していた開発者が、数週間後にたまたま発見するといった形でしか解決に至らないことが多い。
この問題に対して、「それでは認証情報をlocalStorageではなくsessionStorageに保存すれば良いのではないか」と考える人もいるかもしれない。sessionStorageはタブごとに独立したストレージ領域を持つため、タブ間の状態不一致は確かに解消されるように見える。しかし、sessionStorageにもまた別の複雑な挙動が存在する。MDN Web Docsによると、新しいタブが作成された際、それがどのように開かれたかによってsessionStorageの初期状態が変わるのだ。例えば、JavaScriptのwindow.open(url)メソッドを使って開かれたタブは、元のタブのsessionStorageの内容をコピーして開始することがある。一方で、HTMLの<a target="_blank">タグを使ってリンクを開いた場合は、通常rel="noopener"属性が暗黙的に適用されるため、元のタブとは独立したsessionStorageを持つことになる。同じ見た目のリンクでも、その開き方一つでsessionStorageの初期状態が異なるという、さらに複雑な問題を引き起こす可能性があるのだ。
このように、ブラウザの挙動やウェブ標準の細部に潜む特性が、複数のタブを扱う複雑なウェブアプリケーションにおいて、予期せぬバグを引き起こすことがある。これらの問題は単一タブでのテストでは決して見つけることができず、問題の本質がユーザーからの報告には含まれないことが多いため、開発者がブラウザの内部挙動を深く理解し、多角的な視点からテストを行うことの重要性を強く示唆している。