declarativeNetRequest.testMatchOutcome

检查扩展的任何 declarativeNetRequest 规则是否与假设请求匹配。仅在测试期间可用,因为这是用于扩展开发的。有关如何在每个浏览器中启用测试的详细信息,请参见测试

语法

js
let result = await browser.declarativeNetRequest.testMatchOutcome(
    request,                // 对象
    options                 // 可选的对象
);

参数

request

要测试的请求的详细信息。

initiator 可选

string。假设请求的发起者 URL(如果有)。

method 可选

string。假设请求的标准 HTTP 方法(小写)。默认为 HTTP 请求的 "get",对于非 HTTP 请求,则忽略此项。

tabId 可选

number。发生假设请求的标签页的 ID。不需要对应实际标签页的 ID。默认为 -1,表示请求与标签页无关。

type

declarativeNetRequest.ResourceType。假设请求的资源类型。

url

string。假设请求的 URL。

options 可选

请求选项的详细信息。

includeOtherExtensions 可选

boolean。表示是否在 matchedRules 中包含其他扩展的匹配规则。当其他扩展的规则匹配时,生成的 matchedRule 将具有 extensionId 属性。默认为 false

返回值

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

matchedRules

declarativeNetRequest.MatchedRule。与假设请求匹配的规则的详细信息(如果有)。

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

示例

浏览器兼容性

BCD tables only load in the browser