From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/storage/setitem/index.html | 139 ++++++++++++++++++++++++++++ 1 file changed, 139 insertions(+) create mode 100644 files/ja/web/api/storage/setitem/index.html (limited to 'files/ja/web/api/storage/setitem') diff --git a/files/ja/web/api/storage/setitem/index.html b/files/ja/web/api/storage/setitem/index.html new file mode 100644 index 0000000000..3cff60fbdc --- /dev/null +++ b/files/ja/web/api/storage/setitem/index.html @@ -0,0 +1,139 @@ +--- +title: Storage.setItem() +slug: Web/API/Storage/setItem +tags: + - API + - Method + - Reference + - Storage + - Web Storage +translation_of: Web/API/Storage/setItem +--- +

{{APIRef("Web Storage API")}}

+ +

{{domxref("Storage")}} インターフェイスの setItem() メソッドはキーの名称と値を渡すと、ストレージにキーを追加する、またはキーがすでに存在する場合はキーに対する値を更新します。

+ +

構文

+ +
storage.setItem(keyName, keyValue);
+ +

引数

+ +
+
keyName
+
作成または更新したいキーの名称を持つ {{domxref("DOMString")}}。
+
keyValue
+
作成または更新するキーに対して渡したい値を持つ {{domxref("DOMString")}}。
+
+ +

戻り値

+ +

戻り値なし。

+ +

例外

+ +

setItem() は、ストレージが満杯である場合に例外が発生します。特に Mobile Safari (iOS 5 以降) では、ユーザがプライベートモードに入っているときに必ず例外が発生します (Safari はプライベートモードで、クォータを 0 バイトに設定します。一方他のブラウザは別のデータコンテナを使用して、プライベートモードでもストレージを使用できます)。
+ 従って開発者は、setItem() で発生する可能性がある例外を常にキャッチするようにしてください。

+ +

例

+ +

以下の関数はローカルストレージに 3 個のデータアイテムを作成します。

+ +
function populateStorage() {
+  localStorage.setItem('bgcolor', 'red');
+  localStorage.setItem('font', 'Helvetica');
+  localStorage.setItem('image', 'myCat.png');
+}
+ +
+

注記: 実際の例として、Web Storage Demo をご覧ください。

+
+ +

仕様

+ + + + + + + + + + + + + + +
仕様書策定状況コメント
{{SpecName('Web Storage', '#dom-storage-setitem', 'setItem()')}}{{Spec2('Web Storage')}}
+ +

ブラウザ実装状況

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
機能ChromeFirefox (Gecko)Internet ExplorerOperaSafari (WebKit)
localStorage43.5810.504
sessionStorage52810.504
+
+ +
+ + + + + + + + + + + + + + + + + + + +
機能AndroidFirefox Mobile (Gecko)IE PhoneOpera MobileSafari Mobile
基本サポート2.1{{CompatUnknown}}811iOS 3.2
+
+ +

すべてのブラウザで、localStorage および sessionStorage が受け入れる容量は異なります。さまざまなブラウザのストレージ容量を報告しているページがあります。

+ +
+

注記: iOS 5.1 より Safari Mobile は localStorage データを cache フォルダに保存しており、概して空き容量が少ない場合に OS の要求により、時々クリーンアップを受けます。

+
+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf