WorkletSharedStorage:length() 方法

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

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

语法

js
length()

参数

无。

返回值

一个 Promise,它最终会解析为一个数字,该数字代表当前共享存储中键值对的总数。

异常

TypeError

在以下情况下抛出

  • 尚未通过 addModule() 添加 worklet 模块。
  • 调用站点未在成功的 隐私沙盒注册流程中包含共享存储 API。
  • 浏览器由于其他原因未能检索到条目数量。

示例

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

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

规范

此特性似乎未在任何规范中定义。

浏览器兼容性

另见