declarativeNetRequest.HeaderInfo
Der Antwortheader, der für die Anfrage abgeglichen werden soll, deklariert im rule.condition.excludedResponseHeaders-Array oder rule.condition.responseHeaders-Array. Wenn angegeben, muss das Array nicht leer sein.
Wenn es in den responseHeaders der Bedingung verwendet wird, stimmt die Regel überein, wenn die Anfrage mit dieser Antwortheader-Bedingung übereinstimmt. Wenn es in den excludedResponseHeaders der Bedingung verwendet wird, stimmt die Regel nicht überein, wenn die Anfrage mit dieser Antwortheader-Bedingung übereinstimmt.
Jedes Objekt beschreibt einen Header, der abgeglichen oder ausgeschlossen werden soll. Um mehrere Header zu überprüfen, können mehrere Objekte in diesen Arrays oder in mehreren Regeln angegeben werden.
Hinweis:Die Übereinstimmung nach Headern ist eine relativ neue Funktion. Stellen Sie sicher, dass Sie die Verfügbarkeit dieser Funktion erkennen, bevor Sie sich darauf verlassen. Während einige Browser die gesamte Regel ignorieren, wenn eine nicht erkannte Bedingung vorhanden ist, hat Chrome 121 bis 127 die gesamte Regel angewendet, während es dieresponseHeaders-Bedingung ignoriert hat. 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:
header-
Ein
string. Der Name des Headers. Diese Bedingung stimmt nur dann mit dem Namen überein, wenn wedervaluesnochexcludedValuesangegeben sind. valuesOptional-
Ein Array von
string. Wenn angegeben, stimmt diese Bedingung überein, wenn der Wert des Headers mit mindestens einem Muster in dieser Liste übereinstimmt. Dies unterstützt eine fallunempfindliche Übereinstimmung von Header-Werten sowie die folgenden Konstrukte:'*': Entspricht einer beliebigen Anzahl von Zeichen.'?': Entspricht null oder einem Zeichen.'*'und'?'können mit einem Rückwärts-Schrägstrich maskiert werden, z.B.'\*'und'\?'.
excludedValuesOptional-
Ein Array von
string. Wenn angegeben, wird diese Bedingung nicht erfüllt, wenn der Header existiert, aber sein Wert mindestens ein Element in dieser Liste enthält. Dies verwendet dieselbe Glob-Muster-Syntax wievalues. WennvaluesundexcludedValuesbeide übereinstimmen, hatexcludedValuesVorrang.