declarativeNetRequest.getMatchedRules

返回扩展匹配的所有规则。调用者可以通过指定 filter 来过滤匹配规则的列表。此方法仅适用于具有 "declarativeNetRequestFeedback" 权限或在 filter 中指定的 tabId 具有 "activeTab" 权限的扩展。五分钟前匹配的与活动文档无关的规则不会返回。

语法

let gettingMatchedRules = browser.declarativeNetRequest.getMatchedRules(
    filter                // object
);

参数

filter 可选

用于过滤匹配规则列表的对象。

minTimeStamp 可选: 一个 number。如果指定，则只匹配指定时间戳后的规则。
tabId 可选: 一个 number。如果指定，则只匹配指定标签页的规则。如果设置为 -1，则匹配与任何活动标签页无关的规则。

返回值

一个 Promise，它以具有以下属性的对象来实现

rule: declarativeNetRequest.MatchedRule。匹配规则的详细信息。
tabId: number 请求起源标签页的 tabId，如果标签页仍然处于活动状态。否则为 -1。
timeStamp: number 规则匹配的时间。时间戳对应于 JavaScript 的时间约定，即自纪元以来的毫秒数。

如果没有任何规则匹配，则对象为空。如果请求失败，则 promise 将被错误消息拒绝

示例

浏览器兼容性

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