このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

storage.managed

storage.StorageArea オブジェクトであり、managed ストレージ領域を表します。managed ストレージ内のアイテムは、ドメイン管理者またはユーザーのコンピューターにインストールされた他のネイティブアプリケーションによって設定され、拡張機能からは読み取り専用です。このストレージ領域を変更しようとすると、エラーが発生します。

managed ストレージの設定

managed ストレージを設定する手順はブラウザーによって異なります。Chrome での手順は、"Manifest for storage areas"(英語) の記事を参照してください。

Firefox では、特定の形式と場所に JSON マニフェスト(ネイティブマニフェスト)ファイルを作成するか、3rdparty エンタープライズポリシーを使用する必要があります。

ネイティブマニフェストの例を示します。

json
{
  "name": "favourite-colour-examples@mozilla.org",
  "description": "ignored",
  "type": "storage",
  "data": {
    "colour": "management thinks it should be blue!"
  }
}

このマニフェストを使うと、favourite-colour 拡張機能は次のようなコードでデータにアクセスできます。

js
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 から派生したものです。