webRequest.RequestFilter

Объект, описывающий фильтры для применения к событиям webRequest.

Тип

Значения этого типа являются объектами. Они содержат следующие свойства:

urls: array string. Массив шаблонов соответствия. Прослушиватель будет вызываться только для запросов, цели которых соответствуют любому из указанных шаблонов. Только запросы, выполненные с использованием HTTP или HTTPS, будут вызывать события; другие протоколы (например, data: и file:) поддерживаемые шаблонами соответствия, не вызывают событий. view-source: запросы могут сопоставляться на основе внутреннего URL.
types Необязательно: array webRequest.ResourceType. Список типов ресурсов (например, таблицы стилей, изображения, скрипты). Прослушиватель будет вызываться только для запросов ресурсов, которые являются одним из указанных типов.
tabId Необязательно: integer. Прослушиватель будет вызываться только для запросов из tab с этим идентификатором.
windowId Необязательно: integer. Прослушиватель будет вызываться только для запросов из window с этим идентификатором.
incognito Необязательно: boolean. Если указано, запросы, которые не соответствуют состоянию инкогнито (true или false ), будут отфильтрованы.

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`RequestFilter`	Да Если фильтр содержит нераспознанные значения в свойстве `types`, `addListener()` генерирует исключение.	14 Если фильтр содержит нераспознанные значения в свойстве `types`, `addListener()` генерирует исключение.	45 ["Если фильтр содержит нераспознанные значения в свойстве `types`, эти значения игнорируются, и `addListener()` продолжается.", "До Firefox 78, если фильтр содержал нераспознанные значения в свойстве `types`, `addListener()` генерировало исключение."]	?	Да Если фильтр содержит нераспознанные значения в свойстве `types`, `addListener()` генерирует исключение.	14	?	?	48 Если фильтр содержит нераспознанные значения в свойстве `types`, `addListener()` генерирует исключение.	?	Нет	?
`tabId`	Да	14	53	?	Да	14	?	?	53	?	Нет	?
`urls`	Да	14	45 В предыдущих версиях Firefox адреса moz-extension:// не допускались.	?	Да	14	?	?	48 В предыдущих версиях Firefox адреса moz-extension:// не допускались.	?	Нет	?
`view-source`	Да	14	84	?	Да	Нет	?	?	Нет	?	Нет	?
`windowId`	Да	14	53	?	Да	14	?	?	53	?	Нет	?

Примечание: Этот API основан на API chrome.webRequest от Chromium. Данная документация взята из web_request.json в коде Chromium.

© 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/webRequest/RequestFilter