StorageArea.getBytesInUse()

获取存储区域中存储的一个或多个项所使用的存储空间(以字节为单位)。

注意:在 Firefox 中,此方法自 Firefox 131 起在

注意:storage.managed.getBytesInUse() 始终返回 0,至少在 Chrome 和 Firefox 中是这样。

语法

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

其中 <storageType> 是存储类型之一 — synclocalsessionmanaged

在 Firefox 中,因为 bug 1385832 的原因,<storageType> 不能是 storage.local

参数

keys

一个键(字符串)或键(字符串数组),用于标识您想检索其存储空间的项。如果传入一个空数组,则返回 0。如果传入 nullundefined,则该函数返回整个存储区域使用的空间。

返回值

一个 Promise,当成功时,该 Promise 会以一个整数 bytesUsed fulfilled,表示 keys 中指定的对象所使用的存储空间。如果操作失败,Promise 将以错误消息 rejected。

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.storage API。本文档源自 Chromium 代码中的 storage.json