declarativeNetRequest.testMatchOutcome

Проверяет, будут ли соответствовать какие-либо правила расширения declarativeNetRequest гипотетическому запросу. Доступно только во время тестирования, так как предназначено для использования при разработке расширений. Подробности о включении тестирования в каждом браузере см. в разделе Тестирование.

Синтаксис

let result = await browser.declarativeNetRequest.testMatchOutcome(
    request,                // object
    options                 // optional object
);

Параметры

request

Подробности запроса для проверки.

initiator Необязательно: A string. URL инициатора (при наличии) для гипотетического запроса.
method Необязательно: A string. Стандартный (в нижнем регистре) HTTP-метод гипотетического запроса. По умолчанию "get" для HTTP-запросов и игнорируется для запросов, не относящихся к HTTP.
tabId Необязательно: A number. ID вкладки, в которой происходит гипотетический запрос. Не обязательно соответствовать реальному ID вкладки. По умолчанию -1, что означает, что запрос не связан с вкладкой.
type: declarativeNetRequest.ResourceType. Тип ресурса гипотетического запроса.
url: A string. URL гипотетического запроса.

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

Подробности параметров запроса.

includeOtherExtensions Необязательно: A boolean. Включать ли правила сопоставления из других расширений в matchedRules. Если правила из других расширений соответствуют, полученный matchedRule имеет свойство extensionId. По умолчанию false.

Значение возврата

A Promise, который выполняется с объектом, имеющим следующие свойства:

matchedRules: declarativeNetRequest.MatchedRule. Подробности правил (если таковые имеются), которые соответствуют гипотетическому запросу.

Если правила не соответствуют, массив matchedRules пуст. Если запрос завершается ошибкой, обещание отклоняется с сообщением об ошибке.

Примеры

Совместимость с браузерами

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`testMatchOutcome`	103	103	Нет	?	89	Нет	?	?	Нет	?	Нет	?
`options`	Нет	Нет	Нет	?	Нет	Нет	?	?	Нет	?	Нет	?

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/declarativeNetRequest/testMatchOutcome