A RetroSearch Logo

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Search Query:

Showing content from http://developer.mozilla.org/ja/docs/Web/API/Window/localStorage below:

Window: localStorage プãƒãƒ‘ティ - Web API

Window: localStorage プロパティ

Baseline Widely available

localStorage は window プロパティの読み取り専用プロパティで、この Document の origin における Storage オブジェクトにアクセスできます。格納されたデータは、ブラウザーのセッションを跨いで保存されます。

localStorage は sessionStorage によく似ていますが、 localStorage のデータには期限がないのに対し、 sessionStorage のデータはページセッションが終了したとき、すなわちページが閉じられたときにクリアされます。（「プライベートブラウジング」や「プライバシーモード」のセッションに読み込まれた文書の localStorage のデータは、最後の「プライベート」タブが閉じられたときにクリアされます。）

値

現在のオリジンのローカルストレージ領域にアクセスするのに使用できる Storage オブジェクトを返します。

例外
SecurityError

以下のいずれかの場合に発生します。

なお、ユーザーが Cookie をブロックしている場合、ブラウザーはこれをデータの永続化の拒否と解釈する可能性が高いです。

解説

localStorage に保存されるキーと値は常に UTF-16 文字列であり、 1 文字あたり 2 バイトを使用します。オブジェクトと同様に、整数のキーは自動的に文字列に変換されます。

localStorage のデータはその文書のプロトコルに依存することに注意する必要があります。特に、 http://example.com のような HTTP で読み込まれているページにおける localStorage は、https://example.com のような対応する HTTPS で読み込まれているページにおける localStorage とは異なるオブジェクトを返します。

文書が file: URL から読み込まれている（すなわち、ファイルをウェブサーバーから読み込んだのではなくローカルのファイルシステムからブラウザーで直接開いている）場合、localStorage に関する要件は定義されておらず、ブラウザーによって異なる可能性があります。

現在の全てのブラウザーにおいて、 localStorage はそれぞれの file: URL に対して異なるオブジェクトを返すようです。すなわち、それぞれの file: URL がそれぞれ独自のローカルストレージ領域を持つようです。しかし、前述のように file: URL における要件は未定義なので、この挙動は保証されず、この挙動に頼るべきではありません。ブラウザーは file: URL における localStorage の扱いを変える可能性があり、実際にいくつかのブラウザーは変えています。

例

以下のスニペットでは現在のドメインのローカル Storage オブジェクトにアクセスし、Storage.setItem() を利用してデータを追加しています。

localStorage.setItem("myCat", "Tom");

localStorage からのアイテムの読み込みは以下のようにします。

const cat = localStorage.getItem("myCat");

localStorage からのアイテムの削除は以下のようにします。

localStorage.removeItem("myCat");

localStorage からの全アイテムの削除は以下のようにします。

メモ: 詳細な使用例は、ウェブストレージ API の使用の記事を参照してください。

仕様書 ブラウザーの互換性 関連情報

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4