events.UrlFilter

Beschreibt verschiedene Kriterien für das Filtern von URLs. Wenn alle in den Eigenschaften des Filters angegebenen Kriterien mit der URL übereinstimmen, dann passt der Filter. Filter werden oft als Array von UrlFilters zu API-Methoden bereitgestellt. Zum Beispiel können webNavigation-Listener mit einem Filter hinzugefügt werden, der ein Objekt mit einer einzigen url-Eigenschaft ist, die ein Array von UrlFilters ist, z.B. {url:[UrlFilter, UrlFilter, …]}. Wenn irgendein Filter innerhalb des Arrays von UrlFilters übereinstimmt, wird es als Übereinstimmung für das Array betrachtet. Effektiv werden die Kriterien innerhalb eines einzigen Filters miteinander verbunden (UND-Verbindung), während alle individuellen Filter innerhalb eines Arrays verbunden sind (ODER-Verbindung).

Alle Kriterien sind case-sensitive.

Typ

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

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

hostContains Optional

string. Passt, wenn der Hostname der URL (ohne Protokoll oder Port – siehe schemes und ports) den angegebenen String enthält.

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

string. Passt, wenn der Hostname der URL einer angegebenen Zeichenkette entspricht.

  • Beispiel: "www.example.com" passt zu http://www.example.com und https://www.example.com/, aber nicht zu http://example.com/.
hostPrefix Optional

string. Passt, wenn der Hostname der URL mit einem angegebenen String beginnt.

hostSuffix Optional

string. Passt, wenn der Hostname der URL mit einem angegebenen String endet.

  • Beispiel: ".example.com" passt zu http://www.example.com/, aber nicht zu http://example.com/.
  • Beispiel: "example.com" passt zu http://www.example.com/ und http://fakeexample.com/.
pathContains Optional

string. Passt, wenn das Pfadsegment der URL einen angegebenen String enthält.

pathEquals Optional

string. Passt, wenn das Pfadsegment der URL einem angegebenen String entspricht.

pathPrefix Optional

string. Passt, wenn das Pfadsegment der URL mit einem angegebenen String beginnt.

pathSuffix Optional

string. Passt, wenn das Pfadsegment der URL mit einem angegebenen String endet.

queryContains Optional

string. Passt, wenn das Abfrage-Segment der URL einen angegebenen String enthält.

queryEquals Optional

string. Passt, wenn das Abfrage-Segment der URL einem angegebenen String entspricht.

queryPrefix Optional

string. Passt, wenn das Abfrage-Segment der URL mit einem angegebenen String beginnt.

querySuffix Optional

string. Passt, wenn das Abfrage-Segment der URL mit einem angegebenen String endet.

urlContains Optional

string. Passt, wenn die URL (ohne Fragmentkennung) einen angegebenen String enthält. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.

urlEquals Optional

string. Passt, wenn die URL (ohne Fragmentkennung) einem angegebenen String entspricht. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.

urlMatches Optional

string. Passt, wenn die URL (ohne Fragmentkennung) einem angegebenen regulären Ausdruck entspricht. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.

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

string. Passt, wenn die URL ohne Abfrage-Segment und Fragmentkennung einem angegebenen regulären Ausdruck entspricht. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.

urlPrefix Optional

string. Passt, wenn die URL (ohne Fragmentkennung) mit einem angegebenen String beginnt. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.

  • Beispiel: "https://developer" passt zu https://developer.mozilla.org/ und https://developers.facebook.com/.
urlSuffix Optional

string. Passt, wenn die URL (ohne Fragmentkennung) mit einem angegebenen String endet. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen. Beachten Sie, dass ein implizierter Schrägstrich "/" nach dem Host hinzugefügt wird, sodass "com/" zu https://example.com passt, aber "com" nicht.

schemes Optional

array von string. Passt, wenn das Schema der URL einem der in dem Array angegebenen Schemas entspricht. Da Schemas immer in Kleinbuchstaben umgewandelt werden, sollte es 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 ganze Zahlen und Arrays von ganzen Zahlen enthalten kann. Ganze Zahlen werden als Portnummern interpretiert, während Arrays von ganzen Zahlen als Portbereiche interpretiert werden. Passt, wenn der Port der URL mit einer 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

Hinweis: Diese API basiert auf Chromiums chrome.events API. Diese Dokumentation ist von events.json im Chromium-Code abgeleitet.