declarativeNetRequest.onRuleMatchedDebug
当规则匹配到请求时触发。仅对具有 "declarativeNetRequestFeedback" 权限的扩展可用,因为此功能仅用于调试目的。有关如何在每个浏览器中启用测试的详细信息,请参阅 Testing。
语法
browser.declarativeNetRequest.onRuleMatchedDebug.addListener(listener)
browser.declarativeNetRequest.onRuleMatchedDebug.removeListener(listener)
browser.declarativeNetRequest.onRuleMatchedDebug.hasListener(listener)
事件有三个函数
addListener(listener)-
向此事件添加监听器。
removeListener(listener)-
停止监听此事件。
listener参数是要移除的监听器。 hasListener(listener)-
检查
listener是否已为此事件注册。如果正在监听,则返回true,否则返回false。
addListener 语法
参数
监听器-
此事件发生时调用的函数。该函数会传递以下参数:
请求-
包含有关规则匹配到的请求信息的对象。
documentId可选-
一个
string。如果此请求是针对框架的,则为框架文档的唯一标识符。 documentLifecycle可选-
一个
string。如果此请求是针对框架的,则为框架文档的生命周期。可能的值为:"prerender"、"active"、"cached"或"pending_deletion"。 frameId-
一个
number。值0表示请求发生在主框架中。正值表示请求发生的子框架的 ID。如果(子)框架的文档已加载(类型为main_frame或sub_frame),则frameId指示此框架的 ID,而不是外层框架的 ID。框架 ID 在选项卡内是唯一的。 frameType可选-
一个
string。如果此请求是针对框架的,则为框架的类型。可能的值为:"outermost_frame"、"fenced_frame"或"sub_frame"。 initiator可选-
一个
string。发起请求的源。这不会因重定向而改变。如果源是匿名的,则使用字符串 'null'。 method(方法)-
一个
string。标准的 HTTP 方法。 parentDocumentId可选-
一个
string。如果此请求是针对框架的并且有父级,则为框架父文档的唯一标识符。 parentFrameId-
一个
number。封装发送请求的框架的框架 ID。如果没有父框架,则设置为-1。 requestId-
一个
string。请求的 ID。请求 ID 在浏览器会话中是唯一的。 tabId-
一个
number。请求发生的选项卡的 ID。如果请求与选项卡无关,则设置为-1。 type-
ResourceType。请求的资源类型。 url-
一个
string。请求的 URL。
rule-
MatchedRule。匹配到的规则的详细信息。
浏览器兼容性
加载中…