WorkletSharedStorage: remainingBudget() 方法

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

remainingBudget()WorkletSharedStorage 接口的方法,它返回当前来源的剩余导航预算。

导航预算是在每个来源的 24 小时内,由于 WindowSharedStorage.selectURL() 调用,允许在 <fencedframe> 内使用的熵位数。这与导航次数不同;而是基于每次调用中潜在的导航次数。每次发生 selectURL() 导航时,相应来源的预算都会减少 URL 选择数量的对数(以 2 为底)。

导航预算是一种机制,旨在限制跨站点数据泄漏到在 围栏框架 中导航到的目标页面的速率。

语法

js
remainingBudget()

参数

无。

返回值

一个 Promise,它会返回一个表示剩余导航预算的数字。

异常

TypeError

如果工作线程模块尚未使用 addModule() 添加,或者如果调用站点在成功的 隐私沙箱注册流程 中未包含共享存储 API,则会抛出此异常。

示例

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

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

规范

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

浏览器兼容性

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

另请参阅