declarativeNetRequest.onRuleMatchedDebug

当规则与请求匹配时触发。此功能仅对具有 "declarativeNetRequestFeedback" 权限的扩展可用,因为这仅用于调试目的。有关在每个浏览器中启用测试的详细信息,请参阅测试

语法

js
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_framesub_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。匹配规则的详细信息。

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
onRuleMatchedDebug
request
request.documentId
request.documentLifecycle
request.frameId
request.frameType
request.initiator
request.method
request.parentDocumentId
request.parentFrameId
request.requestId
request.tabId
request.type
request.url

Legend

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

Full support
Full support
No support
No support
See implementation notes.