declarativeNetRequest.onRuleMatchedDebug

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 в противном случае.

callback

Функция, которая вызывается при наступлении этого события. Функция получает следующие аргументы:

request

Объект, содержащий информацию о запросе, к которому применилось правило.

documentId Необязательно

string. Уникальный идентификатор документа фрейма, если этот запрос относится к фрейму.

documentLifecycle Необязательно

string. Жизненный цикл документа фрейма, если этот запрос относится к фрейму. Возможные значения: "prerender", "active", "cached" или "pending_deletion".

frameId

number. Значение 0 указывает, что запрос происходит в главном фрейме. Положительное значение — ID дочернего фрейма, в котором происходит запрос. Если документ (под-)фрейма загружен (тип — main_frame или sub_frame), frameId указывает ID этого фрейма, а не внешнего фрейма. Идентификаторы фреймов уникальны в рамках вкладки.

frameType Необязательно

string. Тип фрейма, если этот запрос относится к фрейму. Возможные значения: "outermost_frame", "fenced_frame" или "sub_frame".

initiator Необязательно

string. Происхождение, с которого был инициирован запрос. Это не меняется при редиректах. Строка 'null' используется, если это непрозрачное происхождение.

method

string. Стандартный HTTP-метод.

parentDocumentId Необязательно

string. Уникальный идентификатор родительского документа фрейма, если этот запрос относится к фрейму и у него есть родитель.

parentFrameId

number. Идентификатор фрейма, который содержит фрейм, отправивший запрос. Устанавливается в -1, если нет родительского фрейма.

requestId

string. Идентификатор запроса. Идентификаторы запросов уникальны в сессии браузера.

tabId

number. Идентификатор вкладки, в которой происходит запрос. Устанавливается в -1, если запрос не связан с вкладкой.

type

ResourceType. Тип ресурса запроса.

url

string. URL запроса.

rule

MatchedRule. Подробности о совпавшем правиле.