storage.managed
storage.StorageArea オブジェクトであり、managed ストレージ領域を表します。managed ストレージ内のアイテムは、ドメイン管理者またはユーザーのコンピューターにインストールされた他のネイティブアプリケーションによって設定され、拡張機能からは読み取り専用です。このストレージ領域を変更しようとすると、エラーが発生します。
managed ストレージの設定
managed ストレージを設定する手順はブラウザーによって異なります。Chrome での手順は、"Manifest for storage areas"(英語) の記事を参照してください。
Firefox では、特定の形式と場所に JSON マニフェスト(ネイティブマニフェスト)ファイルを作成するか、3rdparty エンタープライズポリシーを使用する必要があります。
ネイティブマニフェストの例を示します。
{
"name": "favourite-colour-examples@mozilla.org",
"description": "ignored",
"type": "storage",
"data": {
"colour": "management thinks it should be blue!"
}
}
このマニフェストを使うと、favourite-colour 拡張機能は次のようなコードでデータにアクセスできます。
let storageItem = browser.storage.managed.get("colour");
storageItem.then((res) => {
console.log(`Managed colour is: ${res.colour}`);
});
メモ: Firefox では、JSON マニフェストまたはポリシーの変更を managed ストレージに読み込むために、ブラウザーの再起動が必要です。他のブラウザーでは、変更は動的に読み込まれます。
メソッド
managed オブジェクトは、storage.StorageArea 型で定義されているメソッドを実装しています。
storage.managed.get()-
ストレージ領域から 1 つ以上のアイテムを取得します。
storage.managed.getBytesInUse()-
ストレージ領域内の 1 つ以上のアイテムが使用しているストレージ容量をバイト単位で取得します。
storage.managed.getKeys()-
ストレージ領域内のすべてのアイテムのキーを取得します。
イベント
managed オブジェクトは、storage.StorageArea 型で定義されているイベントを実装しています。
storage.managed.onChanged-
ストレージ領域内の 1 つ以上のアイテムが変更されたときに発生します。
Example extensions
ブラウザーの互換性
メモ:
この API は Chromium の chrome.storage API に基づいています。このドキュメントは、Chromium のコードにある storage.json から派生したものです。