events.UrlFilter
Beschreibt verschiedene Kriterien zum Filtern von URLs. Wenn alle in den Eigenschaften des Filters angegebenen Kriterien mit der URL übereinstimmen, wird der Filter als passend angesehen. Filter werden häufig API-Methoden als ein Array von UrlFilters 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 dies als Übereinstimmung für das Array angesehen. Effektiv werden die in einem einzelnen Filter angegebenen Kriterien mit einem logischen UND kombiniert, während alle individuellen Filter in einem Array mit einem logischen ODER kombiniert werden.
Alle Kriterien sind schreibempfindlich.
Typ
Werte dieses Typs sind Objekte. Sie enthalten die folgenden Eigenschaften:
Beachten Sie jedoch, dass diese beiden letzten Muster nicht mit der letzten Komponente des Hostnamens übereinstimmen, da kein impliziter Punkt am Ende des Hostnamens hinzugefügt wird. So wird beispielsweise "org."
mit https://borg.com
übereinstimmen, aber nicht mit https://example.org
. Um diese Muster zu treffen, verwenden Sie hostSuffix
.
hostContains
Optional-
string
. Stimmt überein, 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 stimmt mitwww.foobar.com
undfoo.com
überein, 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 mit "foo" übereinstimmt, verwenden Sie
".foo."
.
- Um zu testen, ob eine Hostname-Komponente mit "foo" beginnt, verwenden Sie
hostEquals
Optional-
string
. Stimmt überein, wenn der Hostname der URL mit einem angegebenen String identisch ist.- Beispiel:
"www.example.com"
stimmt mithttp://www.example.com
undhttps://www.example.com/
überein, aber nicht mithttp://example.com/
.
- Beispiel:
hostPrefix
Optional-
string
. Stimmt überein, wenn der Hostname der URL mit einem angegebenen String beginnt. hostSuffix
Optional-
string
. Stimmt überein, wenn der Hostname der URL mit einem angegebenen String endet.- Beispiel:
".example.com"
stimmt mithttp://www.example.com/
überein, aber nicht mithttp://example.com/
. - Beispiel:
"example.com"
stimmt mithttp://www.example.com/
undhttp://fakeexample.com/
überein.
- Beispiel:
pathContains
Optional-
string
. Stimmt überein, wenn das Pfadsegment der URL einen angegebenen String enthält. pathEquals
Optional-
string
. Stimmt überein, wenn das Pfadsegment der URL mit einem angegebenen String identisch ist. pathPrefix
Optional-
string
. Stimmt überein, wenn das Pfadsegment der URL mit einem angegebenen String beginnt. pathSuffix
Optional-
string
. Stimmt überein, wenn das Pfadsegment der URL mit einem angegebenen String endet. queryContains
Optional-
string
. Stimmt überein, wenn das Abfrage-Segment der URL einen angegebenen String enthält. queryEquals
Optional-
string
. Stimmt überein, wenn das Abfrage-Segment der URL mit einem angegebenen String identisch ist. queryPrefix
Optional-
string
. Stimmt überein, wenn das Abfrage-Segment der URL mit einem angegebenen String beginnt. querySuffix
Optional-
string
. Stimmt überein, wenn das Abfrage-Segment der URL mit einem angegebenen String endet. urlContains
Optional-
string
. Stimmt überein, wenn die URL (ohne Fragment-Identifikator) einen angegebenen String enthält. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen. urlEquals
Optional-
string
. Stimmt überein, wenn die URL (ohne Fragment-Identifikator) mit einem angegebenen String identisch ist. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen. urlMatches
Optional-
string
. Stimmt überein, 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/.*$"
stimmt mithttps://mozilla.org/
undhttps://developer.mozilla.org/
überein, aber nicht mithttps://developer.fakemozilla.org/
.
- Zum Beispiel:
originAndPathMatches
Optional-
string
. Stimmt überein, 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
. Stimmt überein, wenn die URL (ohne Fragment-Identifikator) mit einem angegebenen String beginnt. Portnummern werden aus der URL entfernt, wenn sie der Standardportnummer entsprechen.- Beispiel:
"https://developer"
stimmt mithttps://developer.mozilla.org/
undhttps://developers.facebook.com/
überein.
- Beispiel:
urlSuffix
Optional-
string
. Stimmt überein, wenn die URL (ohne Fragment-Identifikator) mit einem angegebenen String 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, sodass"com/"
mithttps://example.com
übereinstimmt, aber"com"
nicht. schemes
Optional-
array
vonstring
. Stimmt überein, wenn das Schema der URL mit einem der in dem Array angegebenen Schemen identisch ist. Da Schemen immer in Kleinbuchstaben konvertiert werden, sollte dies immer in Kleinbuchstaben angegeben werden, sonst wird es nie übereinstimmen.- Beispiel:
["https"]
stimmt nur mit HTTPS-URLs überein.
- Beispiel:
ports
Optional-
array
von (integer
oder (array
voninteger
)). 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 Bereich von Ports interpretiert werden. Stimmt überein, wenn der Port der URL mit einer Portnummer übereinstimmt oder in einem der Bereiche enthalten ist.- Zum Beispiel:
[80, 443, [1000, 1200]]
stimmt mit allen Anfragen auf den Ports 80, 443 und im Bereich 1000-1200 überein.
- Zum Beispiel:
Browser-Kompatibilität
BCD tables only load in the browser
Hinweis: Diese API basiert auf der chrome.events
API von Chromium. Diese Dokumentation stammt aus events.json
im Chromium-Code.