declarativeNetRequest.getMatchedRules
返回扩展匹配到的所有规则。调用者可以通过指定 filter 来过滤匹配到的规则列表。此方法仅对拥有 "declarativeNetRequestFeedback" 权限的扩展可用,或者对 filter 中指定的 tabId 拥有 "activeTab" 权限的扩展可用。不与活动文档相关联且在五分钟前匹配到的规则不会被返回。
语法
js
let gettingMatchedRules = await browser.declarativeNetRequest.getMatchedRules(
filter // object
);
参数
filter可选-
用于过滤匹配规则列表的对象。
minTimeStamp可选-
一个
number。如果指定,则仅匹配指定时间戳之后的规则。 tabId可选-
一个
number。如果指定,则仅匹配指定标签页的规则。如果设置为-1,则匹配不与任何活动标签页关联的规则。
返回值
一个 Promise,它将以具有这些属性的对象解析
rule-
declarativeNetRequest.MatchedRule。匹配规则的详细信息。 tabId-
number请求来源的标签页的tabId,如果该标签页仍然处于活动状态。否则为-1。 timeStamp-
number规则匹配的时间。时间戳对应 JavaScript 的时间约定,即自纪元以来的毫秒数。
如果没有匹配到规则,则返回空对象。如果请求失败,Promise 将以错误消息被拒绝。
示例
浏览器兼容性
加载中…