declarativeNetRequest.onRuleMatchedDebug

當規則匹配到請求時觸發。僅對具有 "declarativeNetRequestFeedback" 許可權的擴充套件可用,因為此功能僅用於除錯目的。有關如何在每個瀏覽器中啟用測試的詳細資訊,請參閱 Testing

語法

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 語法

引數

監聽器

此事件發生時呼叫的函式。該函式會傳遞以下引數:

請求

包含有關規則匹配到的請求資訊的物件。

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。匹配到的規則的詳細資訊。

瀏覽器相容性