declarativeNetRequest.getMatchedRules

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

语法

js
let gettingMatchedRules = browser.declarativeNetRequest.getMatchedRules(
    filter                // 对象
);

参数

filter 可选

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

minTimeStamp 可选

number。如果指定,则仅匹配在指定时间戳之后的规则。

tabId 可选

number。如果指定,则仅匹配指定标签页的规则。如果设置为 -1,则匹配与任何活动标签页无关的规则。

返回值

一个 Promise,其会兑现一个对象,具有以下属性:

rule

declarativeNetRequest.MatchedRule。匹配规则的详细信息。

tabId

number。请求来源的标签页的 tabId,如果标签页仍然活跃。否则为 -1

timeStamp

number。匹配规则的时间。时间戳对应于 JavaScript 的时间约定,即自纪元以来的毫秒数。

如果没有匹配的规则,则对象为空。如果请求失败,promise 将被拒绝并带有错误消息。

示例

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getMatchedRules

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support