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);
}

規範

此特性似乎未在任何規範中定義。

瀏覽器相容性

另見