From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../add-ons/webextensions/api/storage/index.html | 109 +++++++++++++++++ .../webextensions/api/storage/local/index.html | 84 +++++++++++++ .../api/storage/storagearea/clear/index.html | 62 ++++++++++ .../api/storage/storagearea/get/index.html | 133 +++++++++++++++++++++ .../storage/storagearea/getbytesinuse/index.html | 53 ++++++++ .../api/storage/storagearea/index.html | 73 +++++++++++ .../api/storage/storagearea/remove/index.html | 70 +++++++++++ .../api/storage/storagearea/set/index.html | 105 ++++++++++++++++ .../api/storage/storagechange/index.html | 79 ++++++++++++ .../webextensions/api/storage/sync/index.html | 87 ++++++++++++++ 10 files changed, 855 insertions(+) create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/storagechange/index.html create mode 100644 files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html (limited to 'files/ja/mozilla/add-ons/webextensions/api/storage') diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/index.html new file mode 100644 index 0000000000..6286012f61 --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/index.html @@ -0,0 +1,109 @@ +--- +title: storage +slug: Mozilla/Add-ons/WebExtensions/API/storage +tags: + - API + - Add-ons + - Extensions + - Interface + - Non-standard + - Reference + - Storage + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/API/storage +--- +
{{AddonSidebar}}
+ +

拡張機能にデータの保存、取得と、保存項目の変更をリッスンできるようにします。

+ +

ストレージのシステムは Web Storage API に基づいていますが、いくつか相違点があります。とりわけ、以下の違いがあります。

+ + + +

この API を利用するためには"storage" permission を manifest.json に含める必要があります。

+ +

各々の拡張機能は独自のストレージ領域を持っています。またそれらは異なる型のストレージに分割することができます。

+ +

{{domxref("Window.localStorage")}}とこの API は似ていますが、拡張機能関連のデータを格納する際に拡張コード内で Window.localStorage を使わないことを推奨します。Firefox はプライバシー上の理由で、ブラウザー履歴やデータを消去などをする場合、localStorage API を利用して保存されたデータも消去します。しかし storage.local API を利用して保存されたデータはこれらの場合でも保持されます。

+ +
+

ストレージ領域内は暗号化されていないため、ユーザーの機密情報を保存すべきではありません。

+
+ +

型

+ +
+
{{WebExtAPIRef("storage.StorageArea")}}
+
ストレージ領域を表すオブジェクト
+
{{WebExtAPIRef("storage.StorageChange")}}
+
ストレージ領域の変更を表すオブジェクト
+
+ +

プロパティ

+ +

storage は 3 つのプロパティを持ち、異なる型の利用可能なストレージ領域を表しています。

+ +
+
{{WebExtAPIRef("storage.sync")}}
+
sync ストレージ領域を表します。sync ストレージ内のアイテムはブラウザーによって同期され、異なるデバイス間でも、ログインしているユーザーのブラウザーのすべてのインスタンスを跨いで利用できるようになります。
+
{{WebExtAPIRef("storage.local")}}
+
local ストレージ領域を表します。local ストレージ内のアイテムは拡張機能がインストールされているマシン内のみで扱えます。
+
{{WebExtAPIRef("storage.managed")}}
+
managed ストレージ領域を表します。managed ストレージ内のアイテムはドメイン管理者によってセットされ、拡張機能は読取権限のみを持ちます。そのため、この名前空間を変更しようとするとエラーになります。
+
+ +

イベント

+ +
+
{{WebExtAPIRef("storage.onChanged")}}
+
ストレージ領域内のアイテムを 1 つ以上変更した場合に発火します。
+
+ +

ブラウザー実装状況

+ +

{{Compat("webextensions.api.storage")}}

+ +

{{WebExtExamples("h2")}}

+ +
Acknowledgements + +

この API は Chromium の chrome.storage API に基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
+ + diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html new file mode 100644 index 0000000000..e69759effd --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/local/index.html @@ -0,0 +1,84 @@ +--- +title: storage.local +slug: Mozilla/Add-ons/WebExtensions/API/storage/local +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/local +--- +
{{AddonSidebar()}}
+ +

local ストレージ領域を指します。localストレージ内のアイテムはその拡張機能がインストールされたマシン内で利用できます。

+ +

ブラウザーは拡張機能がローカルストレージエリアに保存できるデータ量を制限します。

+ + + +

拡張機能をアンインストールすると、関連するローカルストレージは削除されます。

+ +

またFirefoxでは、"about:config"で"keepUuidOnUninstall"と"keepStorageOnUninstall"の設定をtrueにすることで、アンインストール時にデータが削除されることを防ぐことができます。 この機能は拡張機能開発のテストのために提供されています。拡張機能自身ではこれらの設定を変更できません。

+ +

このAPIは {{domxref("Window.localStorage")}}に似ていますが、拡張機能のコード内でWindow.localStorageを使用することは推奨されません。これはユーザがプライバシーのために履歴とデータを削除するなど、FirefoxはlocalStorage APIを用いて拡張機能が保存したデータを削除することがあるためです。

+ +

関数

+ +

localオブジェクトは{{WebExtAPIRef("storage.StorageArea")}} 型で定義された関数を実装しています。

+ +
+
{{WebExtAPIRef("storage.StorageArea.get()")}}
+
ストレージ領域から 1つ以上のアイテムを取得します。
+
{{WebExtAPIRef("storage.StorageArea.getBytesInUse()")}}
+
1つ以上のストレージ領域内に格納されたアイテムが占めるストレージ空間をバイト単位で取得します。
+
{{WebExtAPIRef("storage.StorageArea.set()")}}
+
1つ以上のアイテムをストレージ領域に格納します。既にアイテムが存在していれば値は上書きされます。 値を格納したとき{{WebExtAPIRef("storage.onChanged")}}イベントが発火します。
+
{{WebExtAPIRef("storage.StorageArea.remove()")}}
+
ストレージ領域内の1つ以上のアイテムを削除します。
+
{{WebExtAPIRef("storage.StorageArea.clear()")}}
+
ストレージ領域内の全てのアイテムを削除します。
+
+ +

ブラウザ互換状況

+ + + +

{{Compat("webextensions.api.storage.local")}}

+ +

{{WebExtExamples}}

+ +
Acknowledgements + +

このAPIはChromiumの chrome.storage APIに基づいています。また、このドキュメントは storage.jsonにおける Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
+ + diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html new file mode 100644 index 0000000000..b8dc2aec62 --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/clear/index.html @@ -0,0 +1,62 @@ +--- +title: StorageArea.clear() +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - Storage + - StorageArea + - WebExtensions + - remove +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/clear +--- +
{{AddonSidebar()}}
+ +

全てのアイテムをストレージ領域から削除します。

+ +

この関数は Promise を返す非同期関数です。

+ +

構文

+ +
var clearing = browser.storage.<storageType>.clear()
+
+ +

<storageType> は {{WebExtAPIRef("storage.sync")}} または {{WebExtAPIRef("storage.local")}} の書き込み可能なストレージタイプです。

+ +

引数

+ +

なし

+ +

返り値

+ +

成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

+ +

ブラウザ互換性

+ +

{{Compat("webextensions.api.storage.StorageArea.clear")}}

+ +

例

+ +
function onCleared() {
+  console.log("OK");
+}
+
+function onError(e) {
+  console.log(e);
+}
+
+var clearStorage = browser.storage.local.clear();
+clearStorage.then(onCleared, onError);
+ +

{{WebExtExamples}}

+ +
謝辞 + +

この API は Chromium の chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html new file mode 100644 index 0000000000..d5ea70153c --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/get/index.html @@ -0,0 +1,133 @@ +--- +title: StorageArea.get() +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - Storage + - StorageArea + - WebExtensions + - get +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/get +--- +
{{AddonSidebar()}}
+ +

ストレージ領域から1つ以上のアイテムを取得します。

+ +

この関数は Promise を返す非同期関数です。

+ +

構文

+ +
let gettingItem = browser.storage.<storageType>.get(
+  keys    // null, string, object or array of strings
+)
+
+ +

<storageType> は storage.sync または storage.local の書き込み可能なストレージタイプです。

+ +

引数

+ +
+
keys
+
取得したいアイテムのキー(文字列・文字列の配列またはデフォルト値を指定するオブジェクト)を指定します。空文字列・オブジェクト・配列を指定すると空のオブジェクトが取得できます。 null か未定義の値を指定するとストレージ全体のアイテムが取得できます。
+
+ +

返り値

+ +

成功時は keys で指定されたストレージ領域内のアイテム全てを含む results オブジェクトを引数に持つ Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

+ +
+

52 より前の Firefox バージョンのコンテンツスクリプトで使用する場合、 browser.storage.local.get() で返される Promise は1つのオブジェクトを持つ配列を引数に持ちます。配列内のオブジェクトは上記に記述したようにストレージ領域内の keys を持っています。 The Promise is correctly fulfilled with an Object when used in the background context (background scripts, popups, options pages, etc.). When this API is used as chrome.storage.local.get(), it correctly passes an Object to the callback function.

+
+ +

ブラウザ実装状況

+ +

{{Compat("webextensions.api.storage.StorageArea.get")}}

+ +

例

+ +

あらかじめストレージ領域に2つのアイテムを格納しておきます。

+ +
// "kitten" と "monster" を格納
+browser.storage.local.set({
+  kitten:  {name:"Mog", eats:"mice"},
+  monster: {name:"Kraken", eats:"people"}
+});
+ +

次に promise で使う成功時と失敗時のハンドラを定義しておきます。

+ +
function onGot(item) {
+  console.log(item);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+ +

keys を指定せずに呼び出すと全て取得します。

+ +
let gettingItem = browser.storage.local.get();
+gettingItem.then(onGot, onError);
+
+// -> Object { kitten: Object, monster: Object }
+ +

空のキーを指定すると何も返しません。

+ +
// 空の配列を指定すると何も返らない
+let gettingItem = browser.storage.local.get([]);
+gettingItem.then(onGot, onError);
+
+// -> Object { }
+ +

オブジェクト名を指定すると、合致するものを返します。

+ +
let gettingItem = browser.storage.local.get("kitten");
+gettingItem.then(onGot, onError);
+
+// -> Object { kitten: Object }
+ +

オブジェクト名の配列を指定すると合致するものを全て返します。

+ +
let gettingItem = browser.storage.local.get(["kitten", "monster", "grapefruit"]);
+gettingItem.then(onGot, onError);
+
+// -> Object { kitten: Object, monster: Object }
+ +

オブジェクト名をキー、デフォルト値をvalueに指定したオブジェクトを指定する場合

+ +
let gettingItem = browser.storage.local.get({
+  kitten: "no kitten",
+  monster: "no monster",
+  grapefruit: {
+    name: "Grape Fruit",
+    eats: "Water"
+  }
+});
+
+// -> Object { kitten: Object, monster: Object, grapefruit: Object }
+
+ +

{{WebExtExamples}}

+ +

Chrome での例

+ +
chrome.storage.local.get("kitten", function(items){
+  console.log(items.kitten);  // -> {name:"Mog", eats:"mice"}
+});
+ +

Or with an arrow function

+ +
chrome.storage.local.get("kitten", items=>{
+  console.log(items.kitten); // -> {name:"Mog", eats:"mice"}
+});
+ +
謝辞 + +

この API は Chromium の chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html new file mode 100644 index 0000000000..ae2de4bb9e --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/getbytesinuse/index.html @@ -0,0 +1,53 @@ +--- +title: StorageArea.getBytesInUse() +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse +tags: + - API + - Add-ons + - Method + - Non-standard + - Reference + - Storage + - StorageArea + - WebExtensions + - getBytesInUse +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/getBytesInUse +--- +
{{AddonSidebar()}}
+ +

1つ以上のストレージ領域内に格納されたアイテムが占めるストレージ空間をバイト単位で取得します。

+ +

この関数は Promise を返す非同期関数です。

+ +

構文

+ +
var gettingSpace = browser.storage.<storageType>.getBytesInUse(
+  keys                      // null, string, or array of strings
+)
+
+ +

<storageType> は {{WebExtAPIRef("storage.sync")}} または {{WebExtAPIRef("storage.local")}} の書き込み可能なストレージタイプです。

+ +

引数

+ +
+
keys
+
ストレージ空間を取得したいアイテムのキー(文字列または文字列の配列)を指定します。 空の文字列か配列を渡すと 0 が返ります。 null を指定すると、ストレージ領域全体の使用中ストレージ空間を返します。
+
+ +

返り値

+ +

成功時は keys で指定されたオブジェクトが占めるストレージ空間を持つ整数 bytesUsed を引数に持つ Promise を返します。失敗した場合 Promise はエラーメッセージと共にリジェクトされます。

+ +

ブラウザ実装状況

+ +

{{Compat("webextensions.api.storage.StorageArea.getBytesInUse")}}

+ +

{{WebExtExamples}}

+ +
謝辞 + +

この API は Chromium の chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/index.html new file mode 100644 index 0000000000..5a84d5280d --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/index.html @@ -0,0 +1,73 @@ +--- +title: storage.StorageArea +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea +--- +
{{AddonSidebar()}}
+ +

StorageArea はストレージ領域を表すオブジェクトです。

+ +

型

+ +

StorageAreaはオブジェクト型です。

+ +

関数

+ +
+
{{WebExtAPIRef("storage.StorageArea.get()")}}
+
ストレージ領域から1つ以上のアイテムを取得します。
+
{{WebExtAPIRef("storage.StorageArea.getBytesInUse()")}}
+
ストレージ領域に格納されている1つ以上のアイテムで使用されているストレージサイズ(バイト単位)を取得します。
+
{{WebExtAPIRef("storage.StorageArea.set()")}}
+
1つ以上のアイテムをストレージ領域に保存します。既にアイテムが存在する場合は値が上書きされます。
+
{{WebExtAPIRef("storage.StorageArea.remove()")}}
+
1つ以上のアイテムをストレージ領域から削除します。
+
{{WebExtAPIRef("storage.StorageArea.clear()")}}
+
全てのアイテムをストレージ領域から削除します。
+
+ +

ブラウザ実装状況

+ + + +

{{Compat("webextensions.api.storage.StorageArea")}}

+ +

{{WebExtExamples}}

+ +
謝辞 + +

このAPIはChromium chrome.storage APIに模度づいています。また、このドキュメントは storage.json におけるChromiumのコードに基づいています。

+ +

Microsoft Edge での実装状況はMicrosoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States Licenseに従っています。

+
+ + diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html new file mode 100644 index 0000000000..daba7224fb --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/remove/index.html @@ -0,0 +1,70 @@ +--- +title: StorageArea.remove() +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/remove +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - Storage + - StorageArea + - WebExtensions + - remove +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/remove +--- +
{{AddonSidebar()}}
+ +

1つ以上のアイテムをストレージ領域から削除します。

+ +

この関数は Promise を返す非同期関数です。

+ +

Syntax

+ +
let removingItem = browser.storage.<storageType>.remove(
+  keys             // string, or array of strings
+)
+
+ +

<storageType> は {{WebExtAPIRef("storage.sync")}} または {{WebExtAPIRef("storage.local")}} の書き込み可能なストレージタイプです。

+ +

引数

+ +
+
keys
+
削除したいアイテムのキー(文字列または文字列の配列)を指定します。
+
+ +

返り値

+ +

成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

+ +

ブラウザ実装状況

+ +

{{Compat("webextensions.api.storage.StorageArea.remove")}}

+ +

例

+ +

1つのアイテムを削除する例です。

+ +
function onRemoved() {
+  console.log("OK");
+}
+
+function onError(e) {
+  console.log(e);
+}
+
+let removeKitten = browser.storage.remove("kitten");
+removeKitten.then(onRemoved, onError);
+
+ +

{{WebExtExamples}}

+ +
謝辞 + +

この API は Chromium の chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html new file mode 100644 index 0000000000..6860bc9c19 --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagearea/set/index.html @@ -0,0 +1,105 @@ +--- +title: StorageArea.set() +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - Storage + - StorageArea + - WebExtensions + - set +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageArea/set +--- +
{{AddonSidebar()}}
+ +

1つ以上のアイテムをストレージ領域に保存または上書きします。

+ +

この API を使用して保存や上書きをする場合、{{WebExtAPIRef("storage.onChanged")}} イベントが発火します。

+ +

この関数は Promise を返す非同期関数です。

+ +

構文

+ +
let settingItem = browser.storage.<storageType>.set(
+  keys             // オブジェクト
+)
+
+ +

<storageType> は storage.sync または storage.local の書き込み可能なストレージタイプです。

+ +

Parameters

+ +
+
keys
+
+

保存したい1つ以上のキー/値ペアを持つオブジェクトを指定します。アイテムが既に存在する場合、値は上書きされます。

+ +

値は primitive 型 (整数型・ブール型・文字列) または配列 を指定でできます。

+ +

通常は他の型 (Function, Date, RegExp, Set, Map, ArrayBuffer  など)は格納できません。これらのサポートされていない型の中には空のオブジェクトとして復元されたり、 set() がエラーをスローする場合があります。この場合の挙動はブラウザに依存します。

+
+
+ +

返り値

+ +

成功時は引数の無い Promise を返します。 失敗した場合 promise はエラーメッセージと共にリジェクトされます。

+ +

ブラウザ実装状況

+ +

 

+ +

{{Compat("webextensions.api.storage.StorageArea.set")}}

+ +

 

+ +

例

+ +
function setItem() {
+  console.log("OK");
+}
+
+function gotKitten(item) {
+  console.log(`${item.kitten.name} has ${item.kitten.eyeCount} eyes`);
+}
+
+function gotMonster(item) {
+  console.log(`${item.monster.name} has ${item.monster.eyeCount} eyes`);
+}
+
+function onError(error) {
+  console.log(error)
+}
+
+// オブジェクトを2つ定義
+var monster = {
+  name: "Kraken",
+  tentacles: true,
+  eyeCount: 10
+}
+
+var kitten = {
+  name: "Moggy",
+  tentacles: false,
+  eyeCount: 2
+}
+
+// オブジェクト2つを格納
+browser.storage.local.set({kitten, monster})
+  .then(setItem, onError);
+
+browser.storage.local.get("kitten")
+  .then(gotKitten, onError);
+browser.storage.local.get("monster")
+  .then(gotMonster, onError);
+
+ +

{{WebExtExamples}}

+ +
謝辞 + +

この API は Chromium の chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+
diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/storagechange/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/storagechange/index.html new file mode 100644 index 0000000000..f7850012ad --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/storagechange/index.html @@ -0,0 +1,79 @@ +--- +title: storage.StorageChange +slug: Mozilla/Add-ons/WebExtensions/API/storage/StorageChange +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Storage + - StorageChange + - Type + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/StorageChange +--- +
{{AddonSidebar()}}
+ +
StorageChange はストレージ領域の変更を表すオブジェクトです。
+ +
 
+ +

型

+ +

StorageChange オブジェクトは以下のプロパティを持ちます。

+ +
+
oldValue{{optional_inline}}
+
アイテムの変更前の値が存在すれば、この中に入ります。データ型は特定されておらず、何らかのデータ型が入ります。
+
newValue{{optional_inline}}
+
アイテムの変更後の値があれば、この中に入ります。データ型は特定されておらず、何らかのデータ型が入ります。
+
+ +

ブラウザ実装状況

+ + + +

{{Compat("webextensions.api.storage.StorageChange")}}

+ +

{{WebExtExamples}}

+ +
謝辞 + +

 

+ +

この API は Chromium の chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

+
+ + diff --git a/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html b/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html new file mode 100644 index 0000000000..f9b796ebfb --- /dev/null +++ b/files/ja/mozilla/add-ons/webextensions/api/storage/sync/index.html @@ -0,0 +1,87 @@ +--- +title: storage.sync +slug: Mozilla/Add-ons/WebExtensions/API/storage/sync +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Property + - Reference + - Storage + - Sync + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/API/storage/sync +--- +
{{AddonSidebar()}}
+ +

sync ストレージ領域を指します。 sync ストレージ内のアイテムはブラウザーによって同期され、ログイン(Firefox sync や Google アカウントなど)しているブラウザー・デバイスの全てのインスタンスで利用できます。

+ +

Firefox の場合、ユーザーは "about:preferences" の "Sync 設定" オプションの下にある "アドオン" ボックスにチェックを入れる必要があります。

+ +

storage.sync の実装はアドオン ID に依存していることに注意してください。もし storage.sync を使うのであれば、 browser_specific_settings manifest.json キーを使用して拡張機能に ID を設定する必要があります。

+ +

この API の主な利用例は拡張機能の設定を格納し、異なるプロファイル間で同期させることです。この API は最大100 KB までデータを格納できます。それ以上格納しようとするとエラーメッセージを返して失敗します。 この API は稼働時間やパフォーマンスを保証しません。

+ +

関数

+ +

sync オブジェクトは {{WebExtAPIRef("storage.StorageArea")}} 型で定義された関数を実装しています。

+ +
+
{{WebExtAPIRef("storage.StorageArea.get()", "storage.StorageArea.get()")}}
+
ストレージ領域から1つ以上のアイテムを取得します。
+
{{WebExtAPIRef("storage.StorageArea.getBytesInUse()", "storage.StorageArea.getBytesInUse()")}}
+
1つ以上のストレージ領域内に格納されたアイテムが占めるストレージ空間をバイト単位で取得します。
+
{{WebExtAPIRef("storage.StorageArea.set()", "storage.StorageArea.set()")}}
+
1つ以上のアイテムをストレージ領域に格納します。既にアイテムが存在していれば値は上書きされます。
+
{{WebExtAPIRef("storage.StorageArea.remove()", "storage.StorageArea.remove()")}}
+
ストレージ領域内の1つ以上のアイテムを削除します。
+
{{WebExtAPIRef("storage.StorageArea.clear()", "storage.StorageArea.clear()")}}
+
ストレージ領域内の全てのアイテムを削除します。
+
+ +

ブラウザ実装状況

+ + + +

{{Compat("webextensions.api.storage.sync")}}

+ +

{{WebExtExamples}}

+ +
Acknowledgements + +

このAPIはChromiumの chrome.storage APIに基づいています。また、このドキュメントは storage.json における Chromium のコードに基づいています。

+ +

Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。

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