StorageArea.getBytesInUse()

获取存储区域中一个或多个正在存储的项目的存储空间量(以字节为单位)。

此函数仅存在于 browser.storage.sync 中,它不存在于 browser.storage.local 中。请参阅 https://bugzil.la/1385832

这是一个返回 Promise 的异步函数。

语法

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

<storageType> 只能是 storage.sync,而不是 storage.local,因为 此错误

参数

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

返回值

一个 Promise,它将使用整数 bytesUsed 填充,表示 keys 中指定的项目使用的存储空间。如果操作失败,则 promise 将被拒绝并显示错误消息。

浏览器兼容性

BCD 表格仅在浏览器中加载

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