storage.managed

一個 storage.StorageArea 物件,代表 managed 儲存區域。managed 儲存中的專案由域管理員或安裝在使用者計算機上的其他原生應用程式設定,對擴充套件程式來說是隻讀的。嘗試修改此儲存區域將導致錯誤。

配置託管儲存

配置託管儲存的程式因瀏覽器而異。有關 Chrome 的說明,請參閱 “Manifest for storage areas” 文章。

對於 Firefox,您需要建立一個 特定格式和位置的 JSON manifest(原生 manifest)檔案,或者使用 3rdparty 企業策略

這是一個原生 manifest 示例

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

給定這個 manifest,favourite-colour 擴充套件程式可以使用類似這樣的程式碼來訪問資料

js
let storageItem = browser.storage.managed.get("colour");
storageItem.then((res) => {
  console.log(`Managed colour is: ${res.colour}`);
});

注意:在 Firefox 中,需要重啟瀏覽器才能將 JSON manifest 或策略的更改載入到託管儲存中。在其他瀏覽器中,更改的載入是動態的。

方法

managed 物件實現了 storage.StorageArea 型別上定義的那些方法

storage.managed.get()

從儲存區域檢索一個或多個專案。

storage.managed.getBytesInUse()

獲取儲存區域中一個或多個專案所使用的儲存空間(以位元組為單位)。

storage.managed.getKeys()

檢索儲存區域中所有專案的鍵。

事件

managed 物件實現了 storage.StorageArea 型別上定義的那些事件

storage.managed.onChanged

當儲存區域中的一個或多個專案發生更改時觸發。

擴充套件程式示例

瀏覽器相容性

注意:此 API 基於 Chromium 的 chrome.storage API。本文件源自 Chromium 程式碼中的 storage.json