declarativeNetRequest.ModifyHeaderInfo

Der Anforderungs- oder Antwortheader, der für eine Anfrage geändert werden soll, deklariert im rule.action.requestHeaders Array oder rule.action.responseHeaders Array für Regeln, deren rule.action.type "modifyHeaders" ist.

Jedes Objekt beschreibt eine Header-Änderung. Um mehrere Header zu ändern, können mehrere Objekte in diesen Arrays oder über mehrere Regeln hinweg angegeben werden.

Entsprechende modifyHeaders Regeln werden in der Reihenfolge angewendet, die unter Matching precedence beschrieben wird. Innerhalb jeder Erweiterung werden alle modifyHeaders Regeln mit einer Priorität niedriger oder gleich den entsprechenden allow oder allowAllRequests Regeln ignoriert.

Wenn mehrere modifyHeaders Regeln denselben Header spezifizieren, wird die resultierende Änderung des Headers basierend auf der Priorität der einzelnen Regeln und den angegebenen Operationen bestimmt:

  • Wenn eine Regel einem Header hinzugefügt wurde, können Regeln mit niedrigerer Priorität nur zu diesem Header hinzufügen. set- und remove-Operationen sind nicht erlaubt.
  • Wenn eine Regel einen Header gesetzt hat, können Regeln mit niedrigerer Priorität den Header nicht ändern, außer für append-Regeln aus derselben Erweiterung.
  • Wenn eine Regel einen Header entfernt hat, können Regeln mit niedrigerer Priorität den Header nicht ändern.

Typ

Werte dieses Typs sind Objekte. Sie enthalten folgende Eigenschaften:

Ein string. Der Name des Headers, der geändert werden soll.

operation

Ein string. Die Operation, die an einem Header durchgeführt werden soll. Mögliche Werte sind "append", "set" und "remove".

value Optional

Ein string. Der neue Wert für den Header. Muss für die Operationen append und set angegeben werden. Nicht erlaubt für die "remove"-Operation.

Header-Beschränkungen

In Chrome wird "append" für die folgenden Anforderungs-Header unterstützt:

  • 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

In Firefox benötigt die Erweiterung Host-Berechtigungen für den neuen Wert des Host Headers.

Browser-Kompatibilität

webextensions.api.declarativeNetRequest.RuleAction.requestHeaders

BCD tables only load in the browser

webextensions.api.declarativeNetRequest.RuleAction.responseHeaders

BCD tables only load in the browser