declarativeNetRequest.ModifyHeaderInfo

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

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

Übereinstimmende modifyHeaders-Regeln werden in der Reihenfolge angewandt, die unter Matching precedents beschrieben ist. Innerhalb jeder Erweiterung werden alle modifyHeaders-Regeln mit einer Priorität, die niedriger oder gleich der Priorität von übereinstimmenden allow- oder allowAllRequests-Regeln ist, ignoriert.

Wenn mehrere modifyHeaders-Regeln denselben Header angeben, wird die resultierende Änderung für den Header basierend auf der Priorität jeder Regel und den angegebenen Operationen bestimmt:

  • Wenn eine Regel an einen Header angehängt wurde, können Regeln mit niedrigerer Priorität nur an diesen Header anhängen. 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 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 auszuführende Operation an einem Header. Mögliche Werte sind "append", "set" und "remove".

value Optional

Ein string. Der neue Wert für den Header. Muss für Anfüge- und Setzoperationen angegeben werden. Nicht erlaubt für die "remove"-Operation.

Header-Grenzen

In Chrome wird "append" für die folgenden Anforderungsheader 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