Mustermuster

Mustermuster sind eine Möglichkeit, Gruppen von URLs zu spezifizieren: Ein Mustermuster entspricht einer bestimmten Gruppe von URLs. Sie werden in WebExtensions APIs an einigen Stellen verwendet, vor allem um anzugeben, in welche Dokumente Inhalts-Skripte geladen werden sollen, und um anzugeben, auf welche URLs webRequest Listener hinzugefügt werden sollen.

APIs, die Mustermuster verwenden, akzeptieren normalerweise eine Liste von Mustermustern und führen die entsprechende Aktion aus, wenn die URL mit einem der Muster übereinstimmt. Siehe zum Beispiel den content_scripts Schlüssel in manifest.json.

Struktur von Mustermustern

Hinweis: Einige Browser unterstützen bestimmte Schemata nicht. Überprüfen Sie die Tabelle zur Browser-Kompatibilität für Details.

Alle Mustermuster sind als Zeichenfolgen angegeben. Abgesehen vom speziellen <all_urls> Muster bestehen Mustermuster aus drei Teilen: scheme, host und path. Das Schema und der Host sind durch :// getrennt.

<scheme>://<host><path>

scheme

Die Komponente scheme kann eine von zwei Formen annehmen:

Form Entspricht
* Nur "http" und "https" und in einigen Browsern auch "ws" und "wss".
Eine der folgenden: http, https, ws, wss, ftp, data, file, oder (chrome-)extension. Nur das angegebene Schema.

host

Die Komponente host kann eine von drei Formen annehmen:

Form Entspricht
* Jeder Host.
*. gefolgt von einem Teil des Hostnamens. Der angegebene Host und alle seine Subdomains.
Ein vollständiger Hostname ohne Platzhalter. Nur der angegebene Host.

host darf keine Portnummer enthalten.

host ist nur optional, wenn das scheme "file" ist.

Beachten Sie, dass der Platzhalter nur am Anfang stehen darf.

path

Die Komponente path muss mit einem / beginnen.

Danach kann sie jede Kombination des * Platzhalters und der Zeichen enthalten, die in URL-Pfaden oder Abfragezeichenfolgen erlaubt sind. Im Gegensatz zu host kann die Komponente path den * Platzhalter in der Mitte oder am Ende enthalten, und der * Platzhalter kann mehrmals auftauchen.

Der Wert für den path wird mit dem String abgeglichen, der der URL-Pfad plus die URL-Abfragezeichenfolge ist. Dazu gehört das ? zwischen den beiden, wenn die Abfragezeichenfolge in der URL vorhanden ist. Zum Beispiel, wenn Sie URLs auf einer beliebigen Domain abgleichen wollen, bei denen der URL-Pfad mit foo.bar endet, dann müssen Sie ein Array von Mustermustern wie ["*://*/*foo.bar", "*://*/*foo.bar?*"] verwenden. Das ?* wird benötigt, anstatt einfach bar*, um das Ende * als auf die URL-Abfragezeichenfolge anwendbar zu verankern und nicht auf einen Teil des URL-Pfads.

Weder der URL-Fragment-Identifier noch das #, das ihm vorausgeht, werden als Teil des path betrachtet.

Hinweis: Der Path-Muster-String sollte keine Portnummer enthalten. Das Hinzufügen eines Ports, wie in: http://localhost:1234/*, führt dazu, dass das Mustermuster ignoriert wird. Jedoch, http://localhost:1234 wird mit http://localhost/* übereinstimmen.

<all_urls>

Der spezielle Wert <all_urls> entspricht allen URLs unter einem der unterstützten Schemata: das heißt "http", "https", "ws", "wss", "ftp", "data" und "file".

Beispiele

Muster Beispielhafte Übereinstimmungen Beispielhafte Nicht-Übereinstimmungen

<all_urls>

Entspricht allen URLs.

http://example.org/

https://a.org/some/path/

ws://sockets.somewhere.org/

wss://ws.example.com/stuff/

ftp://files.somewhere.org/

resource://a/b/c/
(unterstütztes Schema)

ftps://files.somewhere.org/
(unterstütztes Schema)

*://*/*

Entspricht allen HTTP-, HTTPS- und WebSocket-URLs.

http://example.org/

https://a.org/some/path/

ws://sockets.somewhere.org/

wss://ws.example.com/stuff/

ftp://ftp.example.org/
(nicht übereinstimmendes Schema)

file:///a/
(nicht übereinstimmendes Schema)

*://*.mozilla.org/*

Entspricht allen HTTP-, HTTPS- und WebSocket-URLs, die bei "mozilla.org" oder einer seiner Subdomains gehostet werden.

http://mozilla.org/

https://mozilla.org/

http://a.mozilla.org/

http://a.b.mozilla.org/

https://b.mozilla.org/path/

ws://ws.mozilla.org/

wss://secure.mozilla.org/something

ftp://mozilla.org/
(nicht übereinstimmendes Schema)

http://mozilla.com/
(nicht übereinstimmender Host)

http://firefox.org/
(nicht übereinstimmender Host)

*://mozilla.org/

Entspricht allen HTTP-, HTTPS- und WebSocket-URLs, die exakt bei "mozilla.org/" gehostet werden.

http://mozilla.org/

https://mozilla.org/

ws://mozilla.org/

wss://mozilla.org/

ftp://mozilla.org/
(nicht übereinstimmendes Schema)

http://a.mozilla.org/
(nicht übereinstimmender Host)

http://mozilla.org/a
(nicht übereinstimmender Pfad)

ftp://mozilla.org/

Entspricht nur "ftp://mozilla.org/".

 ftp://mozilla.org

http://mozilla.org/
(nicht übereinstimmendes Schema)

ftp://sub.mozilla.org/
(nicht übereinstimmender Host)

ftp://mozilla.org/path
(nicht übereinstimmender Pfad)

https://*/path

Entspricht HTTPS-URLs auf jedem Host, deren Pfad "path" ist.

https://mozilla.org/path

https://a.mozilla.org/path

https://something.com/path

http://mozilla.org/path
(nicht übereinstimmendes Schema)

https://mozilla.org/path/
(nicht übereinstimmender Pfad)

https://mozilla.org/a
(nicht übereinstimmender Pfad)

https://mozilla.org/
(nicht übereinstimmender Pfad)

https://mozilla.org/path?foo=1
(nicht übereinstimmender Pfad aufgrund der URL-Abfragezeichenfolge)

https://*/path/

Entspricht HTTPS-URLs auf jedem Host, deren Pfad "path/" ist und die keine URL-Abfragezeichenfolge haben.

https://mozilla.org/path/

https://a.mozilla.org/path/

https://something.com/path/

http://mozilla.org/path/
(nicht übereinstimmendes Schema)

https://mozilla.org/path
(nicht übereinstimmender Pfad)

https://mozilla.org/a
(nicht übereinstimmender Pfad)

https://mozilla.org/
(nicht übereinstimmender Pfad)

https://mozilla.org/path/?foo=1
(nicht übereinstimmender Pfad aufgrund der URL-Abfragezeichenfolge)

https://mozilla.org/*

Entspricht HTTPS-URLs nur bei "mozilla.org", mit jedem URL-Pfad und jeder URL-Abfragezeichenfolge.

https://mozilla.org/

https://mozilla.org/path

https://mozilla.org/another

https://mozilla.org/path/to/doc

https://mozilla.org/path/to/doc?foo=1

http://mozilla.org/path
(nicht übereinstimmendes Schema)

https://mozilla.com/path
(nicht übereinstimmender Host)

https://mozilla.org/a/b/c/

Entspricht nur dieser URL oder dieser URL mit jedem URL-Fragment.

https://mozilla.org/a/b/c/

https://mozilla.org/a/b/c/#section1

 Alles andere.

https://mozilla.org/*/b/*/

Entspricht HTTPS-URLs, die bei "mozilla.org" gehostet sind und deren Pfad irgendwo in der Mitte eine Komponente "b" enthält. Wird mit URLs mit Abfragezeichenfolgen übereinstimmen, wenn der String mit einem / endet.

https://mozilla.org/a/b/c/

https://mozilla.org/d/b/f/

https://mozilla.org/a/b/c/d/

https://mozilla.org/a/b/c/d/#section1

https://mozilla.org/a/b/c/d/?foo=/

https://mozilla.org/a?foo=21314&bar=/b/&extra=c/

https://mozilla.org/b/*/
(nicht übereinstimmender Pfad)

https://mozilla.org/a/b/
(nicht übereinstimmender Pfad)

https://mozilla.org/a/b/c/d/?foo=bar
(nicht übereinstimmender Pfad aufgrund der URL-Abfragezeichenfolge)

file:///blah/*

Entspricht jeder FILE-URL, deren Pfad mit "blah" beginnt.

file:///blah/

file:///blah/bleh

 file:///bleh/
(nicht übereinstimmender Pfad)

Ungültige Mustermuster

Ungültiges Muster Grund
resource://path/ Nicht unterstütztes Schema.
https://mozilla.org Kein Pfad.
https://mozilla.*.org/ "*" im Host muss am Anfang stehen.
https://*zilla.org/ "*" im Host muss das einzige Zeichen sein oder von "." gefolgt werden.
http*://mozilla.org/ "*" im Schema muss das einzige Zeichen sein.
https://mozilla.org:80/ Host darf keine Portnummer enthalten.
*://* Leerer Pfad: dies sollte *://*/* sein.
file://* Leerer Pfad: dies sollte file:///* sein.

Browser-Kompatibilität