WorkletSharedStorage: length() 方法

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

length() 方法是 WorkletSharedStorage 接口的方法,它返回当前存储在当前来源的共享存储中的条目数。

语法

js
length()

参数

无。

返回值

一个 Promise,它会返回一个数字,表示当前共享存储中键值对的总数。

异常

TypeError

如果抛出

  • 尚未使用 addModule() 添加工作线程模块。
  • 调用站点未包含在成功的 隐私沙箱注册流程 中的共享存储 API。
  • 浏览器因其他某些原因而无法检索条目数。

示例

js
// length() available inside a shared storage worklet module

async function retrieveLength() {
  const length = await this.sharedStorage.length();
  console.log(length);
}

规范

规范
共享存储 API
# dom-workletsharedstorage-length

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅