Spec-Zone.ru › Web Extensions

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 поддерживаются следующие заголовки запросов:

  • Accept
  • Accept-Encoding
  • Accept-Language
  • Access-Control-Request-Headers
  • Cache-Control
  • Connection
  • Content-Language
  • Cookie
  • Forwarded
  • If-Match
  • If-None-Match
  • Keep-Alive
  • Range
  • Te
  • Trailer
  • Transfer-Encoding
  • Upgrade
  • Via
  • Want-Digest
  • X-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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API