StorageArea.getBytesInUse()
获取存储区域中存储的一个或多个项所使用的存储空间(以字节为单位)。
注意:在 Firefox 中,此方法自 Firefox 131 起在
storage.sync.storage.session中得到支持。- 自 Firefox 144 起,在
storage.local和storage.managed中得到支持。
注意:storage.managed.getBytesInUse() 始终返回 0,至少在 Chrome 和 Firefox 中是这样。
语法
js
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。