declarativeNetRequest.ModifyHeaderInfo

Der Anfrage- oder Antwort-Header, der für eine Anfrage geändert werden soll. Er wird im Array rule.action.requestHeaders beziehungsweise rule.action.responseHeaders für Regeln angegeben, deren rule.action.type den Wert "modifyHeaders" hat.

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

Passende modifyHeaders-Regeln werden in der unter Rangfolge passender Regeln beschriebenen Reihenfolge angewendet. Innerhalb einer Erweiterung werden alle modifyHeaders-Regeln ignoriert, deren Priorität niedriger oder gleich der Priorität passender allow- oder allowAllRequests-Regeln ist.

Wenn mehrere modifyHeaders-Regeln denselben Header angeben, hängt die resultierende Änderung von der Priorität der einzelnen Regeln und den angegebenen Operationen ab:

• Wenn eine Regel einem Header einen Wert angehängt hat, dürfen Regeln mit niedrigerer Priorität diesem Header nur weitere Werte anhängen. Die Operationen set und remove sind nicht zulässig.
• Wenn eine Regel einen Header gesetzt hat, dürfen Regeln mit niedrigerer Priorität den Header nicht ändern. Ausgenommen sind append-Regeln derselben Erweiterung.
• Wenn eine Regel einen Header entfernt hat, dürfen Regeln mit niedrigerer Priorität den Header nicht ändern.