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 的浏览器中加载。