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

规范

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

浏览器兼容性

另见