declarativeNetRequest.getMatchedRules

Возвращает все сопоставленные правила для расширения. Вызывающие стороны могут отфильтровать список сопоставленных правил, указав filter. Этот метод доступен только расширениям с разрешением "declarativeNetRequestFeedback" или имеющим разрешение "activeTab" для tabId, указанного в filter. Правила, не связанные с активным документом, которые были сопоставлены более пяти минут назад, возвращаются.

Синтаксис

let gettingMatchedRules = browser.declarativeNetRequest.getMatchedRules(
    filter                // object
);

Параметры

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

Объект для фильтрации списка сопоставленных правил.

minTimeStamp Необязательно: number. Если указано, сопоставляются только правила после указанной отметки времени.
tabId Необязательно: number. Если указано, сопоставляются только правила для указанной вкладки. Сопоставляются правила, не связанные ни с какой активной вкладкой, если установлено значение -1.

Возвращаемое значение

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

rule: declarativeNetRequest.MatchedRule. Подробности сопоставленного правила.
tabId: number Идентификатор вкладки, с которой произошел запрос, если вкладка всё ещё активна. В противном случае, -1.
timeStamp: number Время сопоставления правила. Отметки времени соответствуют соглашению JavaScript для времени, т. е. количеству миллисекунд с эпохи.

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

Примеры

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`getMatchedRules`	84	84	Нет	?	70	15.4	?	?	Нет	?	15.4	?

© 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/getMatchedRules