StorageArea.getKeys()

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

語法

js
let results = browser.storage.<storageType>.getKeys();

其中 <storageType> 是儲存型別之一 — synclocalsessionmanaged

引數

此方法不接受任何引數。

返回值

一個 Promise,該 Promise 解析為一個包含儲存項鍵的陣列。

如果操作失敗,Promise 將會以錯誤訊息被拒絕。

如果未設定託管儲存,則返回 undefined

警告:在 Firefox 中,如果擴充套件的託管儲存未透過 原生清單 或使用 3rdparty 企業策略 進行配置,當使用此函式訪問託管儲存時會丟擲異常(請參閱 Firefox bug 1868153)。透過捕獲錯誤可以避免此問題。此問題與不支援 storage.managed_schema 清單鍵有關(請參閱 Firefox bug 1771731)。

示例

假設儲存包含兩個項

js
// storage contains two items, "kitten" and "monster"
browser.storage.local.set({
  kitten: { name: "Mog", eats: "mice" },
  monster: { name: "Kraken", eats: "people" },
});

檢索 storage.local 中所有項的鍵並記錄結果。

js
browser.storage.local
  .getKeys()
  .then((keys) => console.log(keys)) // [ "kitten", "monster" ]
  .catch((err) => console.error(`Error: ${err}`));

瀏覽器相容性