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
- undremove
-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:
header
-
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