JavaScriptのローカルストレージの容量と制限!データ保存の注意点

[PR]

JavaScript

ローカルストレージは、ユーザー設定やキャッシュなどのデータをブラウザに永続的に保存できる便利な仕組みです。ところが、容量の制限やブラウザ間での差異、保存方式の制約などに不注意だとデータ破損やパフォーマンス低下といったトラブルの原因になります。この記事では、JavaScript ローカルストレージ 容量 制限という観点から、制限値、各ブラウザの挙動、実用的な注意点を最新情報を元に網羅的に解説します。どう保存すべきかがきちんとわかる内容ですので、安心して読み進めてください。

JavaScript ローカルストレージ 容量 制限とは何か

ローカルストレージの容量制限とは、ブラウザで提供される Web Storage API の localStorage が、1つのオリジン(プロトコル+ドメイン+ポート)あたりに保存できるデータの最大量を指します。保存できるのは文字列形式のみで、オブジェクト等は JSON に変換する必要があります。容量を超えて保存しようとすると、QuotaExceededError などのエラーが発生します。

この制限は仕様で厳密に定義されているわけではなく、各ブラウザや端末によって異なります。主に 5MB ~ 10MB の範囲が一般的ですが、ブラウザの実装、デバイスの空き容量、設定やプライベートモードなどによって変動することがあります。最新情報を踏まえると、ほとんどの主要ブラウザでは約5MB前後が標準的な制限値となっています。

Web Storage API の仕組み

Web Storage API の localStorage は同期的なキー・バリュー形式のストレージです。keys と values は両方とも文字列である必要があり、他タイプのデータ(オブジェクトや配列など)は JSON.stringify を使って文字列化し、取得する際に JSON.parse を使って復元します。

localStorage は同一オリジン内のすべてのタブ・ウィンドウで共有され、ブラウザや OS を再起動してもデータは残ります。一方で、同期処理であるため大きなデータ操作を行うと UI が固まるなどの問題が起こる可能性があります。

なぜ容量制限が存在するか

容量制限はブラウザの性能維持とユーザー体験の保護のためにあります。過度に大きなデータを同期的に読み書きすると、メインスレッドがブロックされ、ページの描画や応答が遅くなります。また、ストレージ内のデータが壊れたり、メモリ過多でクラッシュしたりする可能性を軽減する役割を持っています。

また、ストレージが無制限だと悪意あるスクリプトが大量に情報を保存してユーザーの端末を圧迫するリスクもあります。ブラウザはこうした悪用を防ぐため、一定の容量制限を設けています。

オリジンとサブドメインによる扱い

localStorage の容量制限はオリジンごとに設定されます。オリジンとは、プロトコル(http/https)、ドメイン、ポートの組です。サブドメインは別のオリジンと見なされるので、それぞれに独立したストレージ容量が与えられる場合があります。

例えば sample.example と api.sample.example があれば、それぞれに制限がかかります。そのため、大きなデータを保存する必要がある際には、サブドメインをうまく分けて利用する設計を検討する価値があります。

主なブラウザごとの容量制限の比較

ローカルストレージの容量制限はブラウザによって異なり、実際の数値はバージョンやプラットフォームによって変動します。ここでは最新情報をもとに主要なブラウザでの制限を比較します。

ブラウザ 容量制限(おおよその値) 備考
Chrome / Chromium 系 約 5MB 各オリジン単位。文字列/キー+値全体のサイズ。
Firefox 約 10MB オリジンごと。プラットフォーム依存で多少変動する。
Safari 約 5MB モバイル/デスクトップで差異が出る場合あり。
Edge(Chromium ベース) 約 5MB Chrome とほぼ同様。
モバイルブラウザ(iOS/Android) 一般的に 5MB 前後 デバイスの保存状況やOSによる制約が影響する。

Chrome や Chromium 系

これらのブラウザでは、localStorage の容量制限は一般に約 5MB です。キー名と値を含めた全体の文字列長で計算されます。UTF-16 で 1文字あたり 2 バイトで計算される点に注意が必要です。大きな JSON データを丸ごと保存しようとすると容易にこの上限に達します。

Firefox の例外的な振る舞い

Firefox は他のブラウザより少し容量に余裕があり、オリジンあたり約 10MB の制限を持つことがあります。デスクトップ版ではこの傾向が強く、モバイル版や特殊設定では異なることがあります。このため、大量のデータを保存する可能性があるアプリでは Firefox の制限を確認する価値があります。

Safari やモバイル環境の注意点

Safari ではデスクトップ・モバイルの両方で約 5MB の上限が一般的です。ただし、バージョンアップで制約が変化する可能性があり、特に iOS のセーブデータ管理やプライベートモードでは保存が制限されることがあります。

容量制限の計測と制限超過時の挙動

容量を使い切るとどうなるか、どのように現在の使用量を確認するかは非常に重要です。ここでは具体的な方法とエラー処理、限界への対応策を解説します。

使用量の推定方法

ブラウザ標準 API には localStorage がどれだけ使われているかを正確に取得するものはありません。ただし、自前で保存されているキーと値の繰り返し読み込みで合計文字数を数え、それをバイト数に換算することでおおよその使用量を推定できます。UTF-16 で文字列を扱うという前提で計算を行います。

QuotaExceededError 等のエラー処理

容量を超えて保存しようとすると、localStorage.setItem メソッドで QuotaExceededError が発生します。この例外を try‐catch で捕らえるよう設計してください。エラーが起きたら古いデータを削除する、ユーザーに通知する、データサイズを削減するなどのフォールバック処理が必要です。

制限テストの実践例

実際にどれくらい保存できるかを試すには、小さな文字列を徐々に増やしながら保存し続けるテストコードが有効です。限界に達したところで例外が出た時点のサイズを記録すると、各ブラウザごとの制限値を把握できます。ただし、このテストは端末の状態やブラウザ設定によって変動するので、本番環境での保証値とはなりません。

実際に保存する際の注意点とベストプラクティス

容量制限を理解したうえで、安全にローカルストレージを使うための設計および実装の工夫が不可欠です。ここでは保存対象の選定、パフォーマンス、セキュリティなど多方面からの注意点を整理します。

保存すべきデータ・避けるべきデータ

ローカルストレージにはテーマ設定や言語、画面設定などの小さなデータを保存するのが適しています。逆に画像データや大きな一覧、膨大なキャッシュなど容量が大きくなるものは保存を避け、IndexedDB 等の別のストレージを検討すべきです。

文字列化とシリアライズのコスト

オブジェクトや配列を保存する場合、JSON.stringify によるシリアライズが必要です。この処理は大きなデータを扱うと重くなり、同期処理である localStorage 呼び出しが UI の応答性に影響することがあります。可能なら処理を分割したり、書き込み頻度を制限する設計を心掛けてください。

セキュリティの観点からの注意

localStorage のデータは JavaScript からアクセス可能なので、クロスサイトスクリプティング(XSS)攻撃に弱いという性質があります。機密データや認証トークン等を保存するのは避け、必要ならサーバー側セキュリティや HttpOnly のクッキー等を利用したほうが安全です。

localStorage と他のブラウザストレージとの比較

localStorage の制限を理解したうえで、他のブラウザストレージと比べてどのような選択が適切かを整理します。用途に応じて最適なストレージを選ぶための比較情報を提供します。

sessionStorage との比較

sessionStorage は localStorage とほぼ同じ API を持ちますが、ブラウザタブが閉じられるとデータが削除されます。容量は localStorage と同程度で、5MB前後が一般的です。永続性を必要としない一時的なデータ保存に向いています。

IndexedDB の優位性

大きなデータ量、構造化データ、バイナリデータなどを保存する場合、IndexedDB が適切です。非同期 API であり、大容量(ギガバイト規模)を扱える設計で、localStorage の制限を超える用途にはこちらを選ぶべきです。

クッキーとの違い

クッキーはサーバーと HTTP ヘッダーでやり取り可能である点で特有の用途がありますが、容量制限が約 4KB 前後と非常に小さいため、ローカルストレージとは用途が異なります。トークン管理やセッション ID はクッキーで、設定や見た目の状態保存はローカルストレージでという棲み分けが一般的です。

まとめ

localStorage の容量制限はおおよそオリジンごとに 5MB 程度であり、ブラウザによってはそれよりも大きくなることがありますが、それでも数 MB レベルの制限であることには変わりません。容量超過時にはエラーが発生するため、例外処理と使用量の見積もりが重要です。

保存対象は小さなデータに限定し、大きな構造化データやバイナリデータは IndexedDB など他ストレージの活用を検討してください。セキュリティ面では機密情報の保存を避けることが望ましく、XSS対策などの基本も押さえる必要があります。

最終的には、localStorage の制限を正しく理解して設計・実装を行うことで、安全でパフォーマンスに優れたユーザー体験を提供できます。必要な場面で他の仕組みを併用することで過不足のないストレージ活用が可能です。

関連記事

特集記事

コメント

この記事へのトラックバックはありません。

TOP
CLOSE