--- title: Window.localStorage slug: Web/API/Window/localStorage tags: - API - Property - Read-only - Reference - Storage - Web Storage - Window - WindowLocalStorage - localStorage translation_of: Web/API/Window/localStorage ---
{{APIRef()}}
localStorage
プロパティはローカルの {{domxref("Storage")}} オブジェクトにアクセスすることができます。 localStorage
は sessionStorage
によく似ています。唯一の違いは、localStorage
に保存されたデータには保持期間の制限はなく、sessionStorage
に保存されたデータはセッションが終わると同時に(ブラウザが閉じられたときに)クリアされてしまうことです。
localStorageまたはsessionStorage
に保存されるデータはそのページのプロトコル固有であることに注意する必要があります。
myStorage = localStorage;
現在のオリジンの local storageスペースにアクセスするのに使用できる {{domxref("Storage")}} オブジェクトを返します。
SecurityError
file:
や data:
スキームを使うときに起こります)。例えば、ユーザーがブラウザー設定で特定オリジンへのデータ永続化のパーミッションを拒否していることもあります。以下のスニペットでは現在のドメインのローカル {{domxref("Storage")}} オブジェクトにアクセスし、{{domxref("Storage.setItem()")}} を利用してデータを追加しています。
localStorage.setItem('myCat', 'Tom');
localStorage 項目の読み込みの文法は以下の通り:
var cat = localStorage.getItem("myCat");
localStorage 項目の削除の文法は以下の通り:
localStorage.removeItem("myCat");
注: 詳細な使用例は Using the Web Storage API の記事を参照してください。
仕様書 | 策定状況 | コメント |
---|---|---|
{{SpecName('HTML WHATWG', 'webstorage.html#dom-localstorage', 'localStorage')}} | {{Spec2('HTML WHATWG')}} |
{{Compat("api.Window.localStorage")}}