events.UrlFilter
Beschreibt verschiedene Kriterien zum Filtern von URLs. Wenn alle in den Eigenschaften des Filters angegebenen Kriterien mit der URL übereinstimmen, dann passt der Filter. Filter werden häufig in einer Array von UrlFilters an API-Methoden übergeben. 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 ein Filter innerhalb des Arrays von UrlFilters übereinstimmt, wird er als Übereinstimmung für das Array betrachtet. Effektiv werden die in einem einzelnen Filter angegebenen Kriterien miteinander AND-verknüpft, während alle einzelnen Filter innerhalb eines Arrays OR-verknüpft sind.
Alle Kriterien sind groß-/kleinschreibungssensitiv.
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 am Ende des Hostnamens kein implizierter Punkt hinzugefügt wird. So passt zum Beispiel "org."
zu https://borg.com
, aber nicht zu https://example.org
. Um diese Muster zu matchen, verwenden Sie hostSuffix
.
hostContains
Optional-
string
. Passt, wenn der Hostname der URL (ohne Protokoll oder Port – sieheschemes
undports
) den angegebenen String enthält.- Um zu testen, ob eine Hostname-Komponente mit "foo" beginnt, verwenden Sie
".foo"
. Dies passt zuwww.foobar.com
undfoo.com
, da am Anfang des Hostnamens ein implizierter Punkt hinzugefügt wird. - Um zu testen, ob eine Hostname-Komponente mit "foo" endet, verwenden Sie
"foo."
. - Um zu testen, ob eine Hostname-Komponente genau mit "foo" übereinstimmt, verwenden Sie
".foo."
.
- Um zu testen, ob eine Hostname-Komponente mit "foo" beginnt, verwenden Sie
hostEquals
Optional-
string
. Passt, wenn der Hostname der URL mit einem angegebenen String übereinstimmt.- Beispiel:
"www.example.com"
passt zuhttp://www.example.com
undhttps://www.example.com/
, aber nicht zuhttp://example.com/
.
- Beispiel:
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 zuhttp://www.example.com/
, aber nicht zuhttp://example.com/
. - Beispiel:
"example.com"
passt zuhttp://www.example.com/
, undhttp://fakeexample.com/
.
- Beispiel:
pathContains
Optional-
string
. Passt, wenn der Pfad der URL einen angegebenen String enthält. pathEquals
Optional-
string
. Passt, wenn der Pfad der URL mit einem angegebenen String übereinstimmt. pathPrefix
Optional-
string
. Passt, wenn der Pfad der URL mit einem angegebenen String beginnt. pathSuffix
Optional-
string
. Passt, wenn der Pfad der URL mit einem angegebenen String endet. queryContains
Optional-
string
. Passt, wenn der Abfrageabschnitt der URL einen angegebenen String enthält. queryEquals
Optional-
string
. Passt, wenn der Abfrageabschnitt der URL mit einem angegebenen String übereinstimmt. queryPrefix
Optional-
string
. Passt, wenn der Abfrageabschnitt der URL mit einem angegebenen String beginnt. querySuffix
Optional-
string
. Passt, wenn der Abfrageabschnitt der URL mit einem angegebenen String endet. urlContains
Optional-
string
. Passt, wenn die URL (ohne Fragmentbezeichner) 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 Fragmentbezeichner) mit einem angegebenen String übereinstimmt. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen. urlMatches
Optional-
string
. Passt, wenn die URL (ohne Fragmentbezeichner) einem angegebenen regulären Ausdruck entspricht. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.- Zum Beispiel:
urlMatches: "^[^:]*:(?://)?(?:[^/]*\\.)?mozilla\\.org/.*$"
passt zuhttps://mozilla.org/
,https://developer.mozilla.org/
, aber nicht zuhttps://developer.fakemozilla.org/
.
- Zum Beispiel:
originAndPathMatches
Optional-
string
. Passt, wenn die URL ohne Abfrageabschnitt und Fragmentbezeichner 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 Fragmentbezeichner) mit einem angegebenen String beginnt. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen.- Beispiel:
"https://developer"
passt zuhttps://developer.mozilla.org/
undhttps://developers.facebook.com/
.
- Beispiel:
urlSuffix
Optional-
string
. Passt, wenn die URL (ohne Fragmentbezeichner) mit einem angegebenen String endet. Portnummern werden aus der URL entfernt, wenn sie mit der Standardportnummer übereinstimmen. Beachten Sie, dass hinter dem Host ein implizierter Schrägstrich "/" hinzugefügt wird, sodass"com/"
zuhttps://example.com
passt, aber"com"
nicht. schemes
Optional-
array
vonstring
. Passt, wenn das Schema der URL mit einem der im Array angegebenen Schemata übereinstimmt. Da Schemata immer in Kleinbuchstaben umgewandelt werden, sollte dies immer in Kleinbuchstaben angegeben werden, da es sonst nie übereinstimmt.- Beispiel:
["https"]
wird nur HTTPS-URLs entsprechen.
- Beispiel:
ports
Optional-
array
von (integer
oder (array
voninteger
)). Ein Array, das Ganzzahlen und Arrays von Ganzzahlen enthalten kann. Ganzzahlen werden als Portnummern interpretiert, während Arrays von Ganzzahlen als Portbereiche interpretiert werden. Passt, wenn der Port der URL mit einer der Portnummern ü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.
- Zum Beispiel:
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromium's chrome.events
API. Diese Dokumentation stammt von events.json
im Chromium-Code.