StorageArea.getKeys()
檢索儲存區域中所有項的鍵。
語法
js
let results = browser.storage.<storageType>.getKeys();
引數
此方法不接受任何引數。
返回值
一個 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}`));
瀏覽器相容性
載入中…