declarativeNetRequest.onRuleMatchedDebug
当规则与请求匹配时触发。仅适用于具有"declarativeNetRequestFeedback"
权限的扩展,因为这仅用于调试目的。有关如何在每个浏览器中启用测试的详细信息,请参阅测试。
语法
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 语法
参数
listener
-
当此事件发生时调用的函数。该函数传递以下参数
request
-
一个包含有关规则匹配的请求的信息的对象。
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
。匹配规则的详细信息。
浏览器兼容性
BCD 表仅在浏览器中加载