declarativeNetRequest.HeaderInfo

Der Antwort-Header, der für die Anfrage übereinstimmen soll, angegeben im Array rule.condition.excludedResponseHeaders oder im Array rule.condition.responseHeaders. Wenn angegeben, muss das Array nicht leer sein.

Wenn im Bedingungsfeld responseHeaders verwendet, stimmt die Regel überein, wenn die Anfrage dieser Antwort-Header-Bedingung entspricht. Wenn im Bedingungsfeld excludedResponseHeaders verwendet, stimmt die Regel nicht überein, wenn die Anfrage dieser Antwort-Header-Bedingung entspricht.

Jedes Objekt beschreibt einen Header, den es zu vergleichen oder auszuschließen gilt. Um mehrere Header zu prüfen, können mehrere Objekte in diesen Arrays oder über mehrere Regeln hinweg angegeben werden.

Hinweis: Das Abgleichen nach Headern ist eine relativ neue Funktion. Stellen Sie sicher, dass Sie die Verfügbarkeit erkennen, bevor Sie sich darauf verlassen. Während einige Browser die gesamte Regel ignorieren, wenn eine unbekannte Bedingung vorhanden ist, wendete Chrome von Version 121 bis 127 die gesamte Regel an, während die Bedingung responseHeaders ignoriert wurde. Dies könnte dazu führen, dass mehr Anfragen als beabsichtigt übereinstimmen, siehe Chromium-Issue 347186592.

Typ

Werte dieses Typs sind Objekte. Sie enthalten folgende Eigenschaften:

Ein string. Der Name des Headers. Diese Bedingung stimmt nur mit dem Namen überein, wenn weder values noch excludedValues angegeben sind.

values Optional

Ein Array von string. Wenn angegeben, stimmt diese Bedingung überein, wenn der Wert des Headers mindestens mit einem Muster in dieser Liste übereinstimmt. Dies unterstützt die Groß-/Kleinschreibung-ignorierende Header-Wert-Abgleich sowie die folgenden Konstrukte:

  • '*' : Entspricht einer beliebigen Anzahl von Zeichen.
  • '?' : Entspricht null oder einem Zeichen.
  • '*' und '?' können mit einem Backslash maskiert werden, z. B. '\*' und '\?'.
excludedValues Optional

Ein Array von string. Wenn angegeben, stimmt diese Bedingung nicht überein, wenn der Header existiert, aber sein Wert mindestens ein Element in dieser Liste enthält. Es verwendet die gleiche Glob-Muster-Syntax wie values. Wenn sowohl values als auch excludedValues übereinstimmen, hat excludedValues Vorrang.

Browser-Kompatibilität

webextensions.api.declarativeNetRequest.RuleCondition.responseHeaders

webextensions.api.declarativeNetRequest.RuleCondition.excludedResponseHeaders