declarativeNetRequest.HeaderInfo

Der Antwort-Header, der für die Anfrage zu matchen ist, wird im rule.condition.excludedResponseHeaders Array oder im rule.condition.responseHeaders Array deklariert. Wenn angegeben, muss das Array nicht leer sein.

Wenn es in der Bedingung responseHeaders verwendet wird, stimmt die Regel überein, wenn die Anfrage dieser Antwort-Header-Bedingung entspricht. Wenn es in der Bedingung excludedResponseHeaders verwendet wird, stimmt die Regel nicht überein, wenn die Anfrage dieser Antwort-Header-Bedingung entspricht.

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

Hinweis: Das Matching von Headern ist ein relativ neues Feature. Stellen Sie sicher, dass Sie die Verfügbarkeit vor der Nutzung erkennen. Während einige Browser die Regel vollständig ignorieren, wenn eine nicht erkannte Bedingung vorliegt, hat Chrome 121 bis 127 die ganze Regel angewendet, während die responseHeaders-Bedingung ignoriert wurde. Dies könnte dazu führen, dass mehr Anfragen als beabsichtigt gematcht werden, siehe Chromium Issue 347186592.

Typ

Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:

Ein string. Der Name des Headers. Diese Bedingung matcht den Namen nur, wenn sowohl Werte als auch ausgeschlossene Werte nicht angegeben sind.

values Optional

Ein Array von string. Wenn angegeben, stimmt diese Bedingung überein, wenn der Wert des Headers mindestens ein Muster in dieser Liste matcht. Dies unterstützt eine Groß-/Kleinschreibung ignorierende Übereinstimmung von Header-Werten sowie die folgenden Konstrukte:

  • '*' : Matcht eine beliebige Anzahl von Zeichen.
  • '?' : Matcht null oder ein Zeichen.
  • '*' und '?' können mit einem Backslash maskiert werden, z.B. '\*' und '\?'.
excludedValues Optional

Ein Array von string. Wenn angegeben, wird diese Bedingung nicht gematcht, wenn der Header existiert, aber sein Wert mindestens ein Element in dieser Liste enthält. Dies 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

BCD tables only load in the browser

webextensions.api.declarativeNetRequest.RuleCondition.excludedResponseHeaders

BCD tables only load in the browser