StorageArea.getBytesInUse()

獲取儲存區域中儲存的一個或多個項所使用的儲存空間（以位元組為單位）。

注意：在 Firefox 中，此方法自 Firefox 131 起在

注意：storage.managed.getBytesInUse() 始終返回 0，至少在 Chrome 和 Firefox 中是這樣。

語法

let gettingSpace = browser.storage.<storageType>.getBytesInUse(
  keys                      // null, string, or array of strings
)

其中 <storageType> 是儲存型別之一 — sync、local、session 或 managed。

在 Firefox 中，因為 bug 1385832 的原因，<storageType> 不能是 storage.local。

keys: 一個鍵（字串）或鍵（字串陣列），用於標識您想檢索其儲存空間的項。如果傳入一個空陣列，則返回 0。如果傳入 null 或 undefined，則該函式返回整個儲存區域使用的空間。

一個 Promise，當成功時，該 Promise 會以一個整數 bytesUsed fulfilled，表示 keys 中指定的物件所使用的儲存空間。如果操作失敗，Promise 將以錯誤訊息 rejected。

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

此頁面最後修改於 2025年10月6日，由 MDN contributors 修改。