WorkletSharedStorage: remainingBudget() 方法

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

WorkletSharedStorage 介面的 remainingBudget() 方法返回當前源的剩餘導航預算。

導航預算是指 <fencedframe> 中允許的熵位數,這是由 WindowSharedStorage.selectURL() 方法每 24 小時按源呼叫所決定的。這並不等同於導航次數;相反,它基於每次呼叫中潛在導航的數量。每次發生 selectURL() 導航時,相應源的預算將減少 URL 選擇數量的以 2 為底的對數。

導航預算是一種機制,旨在限制跨站點資料向 fenced frames 中導航的目標頁面的洩露速率。

語法

js
remainingBudget()

引數

無。

返回值

一個 Promise,它以一個表示剩餘導航預算的數字來fulfilled。

異常

TypeError

如果 worklet 模組尚未透過 addModule() 新增,或者呼叫站點未包含在成功的 隱私沙盒註冊流程 中,則會丟擲此錯誤。

示例

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

async function retrieveBudget() {
  const budget = await this.sharedStorage.remainingBudget();
  console.log(budget);
}

規範

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

瀏覽器相容性

另見