declarativeNetRequest.ModifyHeaderInfo
Заголовок запроса или ответа, который требуется изменить для запроса, объявленный в массиве rule.action.requestHeaders или массиве rule.action.responseHeaders для правил, для которых rule.action.type равно "modifyHeaders".
Каждый объект описывает одно изменение заголовка. Для изменения нескольких заголовков можно указать несколько объектов в этих массивах или в нескольких правилах.
Правила, соответствующие modifyHeaders, применяются в порядке, описанном в разделе Порядок применения правил. В рамках каждого расширения все правила modifyHeaders с приоритетом, меньшим или равным приоритету соответствующих правил allow или allowAllRequests, игнорируются.
Если несколько правил modifyHeaders указывают на один и тот же заголовок, то итоговое изменение заголовка определяется на основе приоритета каждого правила и указанных операций:
- Если правило добавлено в заголовок, то правила с меньшим приоритетом могут только добавить в этот заголовок. Операции
setиremoveнедопустимы. - Если правило установило заголовок, то правила с меньшим приоритетом не могут изменить этот заголовок, за исключением правил
appendиз того же расширения. - Если правило удалило заголовок, то правила с меньшим приоритетом не могут изменить этот заголовок.
Тип
Значения этого типа — объекты. Они содержат следующие свойства:
header-
string. Имя заголовка, который требуется изменить. operation-
string. Операция, которая должна быть выполнена над заголовком. Возможные значения —"append","set", и"remove". -
valueНеобязательно -
string. Новое значение для заголовка. Должно быть указано для операций "добавить" и "установить". Не допускается для операции "удалить".
Пределы заголовков
В Chrome поддерживаются следующие заголовки запросов:
AcceptAccept-EncodingAccept-LanguageAccess-Control-Request-HeadersCache-ControlConnectionContent-LanguageCookieForwardedIf-MatchIf-None-MatchKeep-AliveRangeTeTrailerTransfer-EncodingUpgradeViaWant-DigestX-Forwarded-For
В Firefox расширению необходимы разрешения на доступ к хосту для нового значения заголовка Host.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | |
ModifyHeaderInfo |
86 | 86 | Нет | ? | 72 | Нет | ? | ? | Нет | ? | Нет | ? |
header |
86 | 86 | Нет | ? | 72 | Нет | ? | ? | Нет | ? | Нет | ? |
operation |
86 | 86 | Нет | ? | 72 | Нет | ? | ? | Нет | ? | Нет | ? |
value |
86 | 86 | Нет | ? | 72 | Нет | ? | ? | Нет | ? | Нет | ? |
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на iOS | Samsung Internet | |
ModifyHeaderInfo |
86 | 86 | Нет | ? | 72 | 16.4 | ? | ? | Нет | ? | 16.4 | ? |
header |
86 | 86 | Нет | ? | 72 | 16.4 | ? | ? | Нет | ? | 16.4 | ? |
operation |
86Операция"append" поддерживается начиная с Chrome 108. |
86Операция"append" поддерживается начиная с Edge 108. |
Нет | ? | 72Операция"append" поддерживается начиная с Opera 94. |
16.4 | ? | ? | Нет | ? | 16.4 | ? |
value |
86 | 86 | Нет | ? | 72 | 16.4 | ? | ? | Нет | ? | 16.4 | ? |
webextensions.api.declarativeNetRequest.RuleAction.requestHeaders
Таблицы BCD загружаются только в браузере
webextensions.api.declarativeNetRequest.RuleAction.responseHeaders
Таблицы BCD загружаются только в браузере
© 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/ModifyHeaderInfo