declarativeNetRequest.testMatchOutcome
检查扩展的任何 declarativeNetRequest
规则是否与假设请求匹配。仅在测试期间可用,因为这是用于扩展开发的。有关如何在每个浏览器中启用测试的详细信息,请参见测试。
语法
js
let result = await browser.declarativeNetRequest.testMatchOutcome(
request, // 对象
options // 可选的对象
);
参数
request
-
要测试的请求的详细信息。
options
可选-
请求选项的详细信息。
includeOtherExtensions
可选-
boolean
。表示是否在matchedRules
中包含其他扩展的匹配规则。当其他扩展的规则匹配时,生成的matchedRule
将具有extensionId
属性。默认为false
。
返回值
一个 Promise
,其会兑现一个具有以下属性的对象:
matchedRules
-
declarativeNetRequest.MatchedRule
。与假设请求匹配的规则的详细信息(如果有)。
如果没有规则匹配,则 matchedRules
数组为空。如果请求失败,promise 将被拒绝并带有错误消息。
示例
浏览器兼容性
BCD tables only load in the browser