events.UrlFilter

Typ

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

Beachten Sie jedoch, dass diese letzten beiden Muster nicht mit der letzten Komponente des Hostnamens übereinstimmen werden, da am Ende des Hostnamens kein impliziter Punkt hinzugefügt wird. Zum Beispiel wird "org." https://borg.com entsprechen, aber nicht https://example.org. Um diese Muster zu entsprechen, verwenden Sie hostSuffix.

hostContains Optional

string. Entspricht, wenn der hostname der URL (ohne Protokoll oder Port – siehe schemes und ports) die angegebene Zeichenfolge enthält.

• Um zu testen, ob eine Hostnamen-Komponente mit "foo" beginnt, verwenden Sie ".foo". Dies entspricht www.foobar.com und foo.com, da ein impliziter Punkt am Anfang des Hostnamens hinzugefügt wird.
• Um zu testen, ob eine Hostnamen-Komponente mit "foo" endet, verwenden Sie "foo.".
• Um zu testen, ob eine Hostnamen-Komponente genau mit "foo" übereinstimmt, verwenden Sie ".foo.".

hostEquals Optional

string. Entspricht, wenn der Hostname der URL einer angegebenen Zeichenfolge entspricht.

• Beispiel: "www.example.com" entspricht http://www.example.com und https://www.example.com/, aber nicht http://example.com/.

hostPrefix Optional

string. Entspricht, wenn der Hostname der URL mit einer angegebenen Zeichenfolge beginnt.

hostSuffix Optional

string. Entspricht, wenn der Hostname der URL mit einer angegebenen Zeichenfolge endet.

• Beispiel: ".example.com" entspricht http://www.example.com/, aber nicht http://example.com/.
• Beispiel: "example.com" entspricht http://www.example.com/, und http://fakeexample.com/.

pathContains Optional

string. Entspricht, wenn das Pfadsegment der URL eine angegebene Zeichenfolge enthält.

pathEquals Optional

string. Entspricht, wenn das Pfadsegment der URL einer angegebenen Zeichenfolge entspricht.

pathPrefix Optional

string. Entspricht, wenn das Pfadsegment der URL mit einer angegebenen Zeichenfolge beginnt.

pathSuffix Optional

string. Entspricht, wenn das Pfadsegment der URL mit einer angegebenen Zeichenfolge endet.

queryContains Optional

string. Entspricht, wenn das Abfrage-Segment der URL eine angegebene Zeichenfolge enthält.

queryEquals Optional

string. Entspricht, wenn das Abfrage-Segment der URL einer angegebenen Zeichenfolge entspricht.

queryPrefix Optional

string. Entspricht, wenn das Abfrage-Segment der URL mit einer angegebenen Zeichenfolge beginnt.

querySuffix Optional

string. Entspricht, wenn das Abfrage-Segment der URL mit einer angegebenen Zeichenfolge endet.

urlContains Optional

string. Entspricht, wenn die URL (ohne Fragment-Identifikator) eine angegebene Zeichenfolge enthält. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen.

urlEquals Optional

string. Entspricht, wenn die URL (ohne Fragment-Identifikator) einer angegebenen Zeichenfolge entspricht. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen.

urlMatches Optional

string. Entspricht, wenn die URL (ohne Fragment-Identifikator) einem angegebenen regulären Ausdruck entspricht. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen.

• Zum Beispiel: urlMatches: "^[^:]*:(?://)?(?:[^/]*\\.)?mozilla\\.org/.*$" entspricht https://mozilla.org/, https://developer.mozilla.org/, aber nicht https://developer.fakemozilla.org/.

originAndPathMatches Optional

string. Entspricht, wenn die URL ohne Abfrage-Segment und Fragment-Identifikator einem angegebenen regulären Ausdruck entspricht. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen.

urlPrefix Optional

string. Entspricht, wenn die URL (ohne Fragment-Identifikator) mit einer angegebenen Zeichenfolge beginnt. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen.

• Beispiel: "https://developer" entspricht https://developer.mozilla.org/ und https://developers.facebook.com/.

urlSuffix Optional

string. Entspricht, wenn die URL (ohne Fragment-Identifikator) mit einer angegebenen Zeichenfolge endet. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen. Beachten Sie, dass ein impliziter Schrägstrich "/" nach dem Host hinzugefügt wird, so dass "com/" https://example.com entspricht, aber "com" nicht.

schemes Optional

array von string. Entspricht, wenn das Schema der URL mit einem der im Array angegebenen Schemen übereinstimmt. Da Schemen immer in Kleinbuchstaben umgewandelt werden, sollte dies immer in Kleinbuchstaben angegeben werden, sonst wird es nie übereinstimmen.

• Beispiel: ["https"] wird nur HTTPS-URLs entsprechen.

ports Optional

array von (integer oder (array von integer)). Ein Array, das Ganzzahlen und Arrays von Ganzzahlen enthalten kann. Ganzzahlen werden als Portnummern interpretiert, während Arrays von Ganzzahlen als Portbereiche interpretiert werden. Entspricht, wenn der Port der URL mit einer beliebigen Portnummer übereinstimmt oder in einem der Bereiche enthalten ist.

• Zum Beispiel: [80, 443, [1000, 1200]] entspricht allen Anfragen auf den Ports 80, 443 und im Bereich 1000-1200.

Browser-Kompatibilität