Übereinstimmungsmuster

Ein Übereinstimmungsmuster ist eine URL mit der folgenden Struktur, die zum Angeben einer Gruppe von URLs verwendet wird:

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

schema: Muss einer der folgenden Werte sein und durch einen Doppelschrägstrich (//) vom Rest des Musters getrennt werden:

• http
• https
• Ein Platzhalter *, der nur mit http oder https übereinstimmt
• file

Informationen zum Einschleusen von Inhaltsscripts in nicht unterstützte Schemas wie about: und data: finden Sie unter In zugehörige Frames einschleusen.

host: Ein Hostname (www.example.com). Ein * vor dem Hostnamen, um Subdomains (*.example.com) abzugleichen, oder nur ein Platzhalter *. – Wenn Sie im Hostmuster einen Platzhalter verwenden, muss er das erste oder einzige Zeichen sein und es muss ein Punkt (.) oder Schrägstrich (/) folgen.

path: Ein URL-Pfad (/example). Bei Hostberechtigungen ist der Pfad erforderlich, wird aber ignoriert. Der Platzhalter (/*) sollte nach Konvention verwendet werden.

In Erweiterungen werden Abgleichmuster für eine Vielzahl von Anwendungsfällen verwendet, darunter:

• Einschleusen von Inhaltsskripten
• Hostberechtigungen deklarieren, die für einige Chrome APIs zusätzlich zu ihren eigenen Berechtigungen erforderlich sind
• Zugriff auf webzugängliche Ressourcen gewähren
• Das Senden und Empfangen von Nachrichten wird über den Manifest-Schlüssel „externally_connectable.matches“ zugelassen.

Sonderfälle

"<all_urls>"

 Stimmt mit jeder URL überein, die mit einem zulässigen Schema beginnt, einschließlich aller unter Gültige Muster aufgeführten Muster. Da sich die Änderung auf alle Hosts auswirkt, kann die Überprüfung von Chrome Web Store-Erweiterungen, die sie verwenden, länger dauern.

"file:///"

Ermöglicht die Ausführung Ihrer Erweiterung auf lokalen Dateien. Bei diesem Muster muss der Nutzer manuell Zugriff gewähren. Beachten Sie, dass in diesem Fall drei, nicht zwei Schrägstriche erforderlich sind.

Localhost-URLs und IP-Adressen

Mit http://localhost/* können Sie während der Entwicklung einen Localhost-Port abgleichen. Geben Sie für IP-Adressen die Adresse und ein Wildcard-Zeichen im Pfad an, z. B. http://127.0.0.1/*. Sie können http://*:*/* auch verwenden, um localhost, IP-Adressen und beliebige Ports abzugleichen.

Übereinstimmungsmuster für Top-Level-Domains

In Chrome werden keine Übereinstimmungsmuster für Top-Level-Domains (TLDs) unterstützt. Geben Sie Ihre Übereinstimmungsmuster innerhalb einzelner TLDs an, wie in http://google.es/* und http://google.fr/*.

Beispielmuster

https://*/* oder https://*/

Entspricht jeder URL mit dem https-Schema.

https://*/foo*

Entspricht jeder URL mit dem https-Schema auf einem beliebigen Host mit einem Pfad, der mit foo beginnt. Beispiele für Übereinstimmungen sind https://example.com/foo/bar.html und https://www.google.com/foo.

https://*.google.com/foo*bar

 Entspricht jeder URL mit dem https-Schema auf einem google.com-Host mit einem Pfad, der mit foo beginnt und mit bar endet. Beispiele für Übereinstimmungen sind https://www.google.com/foo/baz/bar und https://docs.google.com/foobar.

file:///foo*

Stimmt mit jeder lokalen Datei überein, deren Pfad mit foo beginnt. Beispiele für Übereinstimmungen sind file:///foo/bar.html und file:///foo.

http://127.0.0.1/* oder http://127.0.0.1/

Stimmt mit jeder URL überein, die das Schema http verwendet und sich auf dem Host 127.0.0.1 befindet. Beispiele für Übereinstimmungen sind http://127.0.0.1/ und http://127.0.0.1/foo/bar.html.

http://localhost/*

Stimmt mit jedem Localhost-Port überein.

*://mail.google.com/ oder *://mail.google.com/*

Stimmt mit jeder URL überein, die mit http://mail.google.com oder https://mail.google.com beginnt.