Übereinstimmungsmuster

Ein Übereinstimmungsmuster ist eine URL mit folgender Struktur, die zur Angabe einer Gruppe von URLs verwendet wird:

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

scheme: Muss einer der folgenden Werte sein und vom Rest des Musters durch einen doppelten Schrägstrich (//) getrennt sein:

• http
• https
• Einen Platzhalter *, der nur http oder https entspricht
• file

Informationen zum Einfügen von Inhaltsskripts in nicht unterstützte Schemas wie about: und data: finden Sie unter In zusammengehörige Frames einfügen.

host: Ein Hostname (www.example.com). Eine * vor dem Hostnamen zum Abgleichen von Subdomains (*.example.com) oder nur ein Platzhalter *. – Falls Sie im Hostmuster einen Platzhalter verwenden, muss dies das erste oder einzige Zeichen sein. Darauf muss ein Punkt (.) oder ein Schrägstrich (/) folgen.

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

Für Erweiterungen werden Übereinstimmungsmuster in verschiedenen Anwendungsfällen verwendet, darunter:

• Inhaltsskript wird eingefügt.
• Hostberechtigungen deklarieren, die für einige Chrome APIs zusätzlich zu ihren eigenen Berechtigungen erforderlich sind
• Zugriff auf über das Web zugängliche Ressourcen gewähren.
• Senden und Empfangen von Nachrichten mit dem Manifestschlüssel "externally_connectable.matches" zulassen.

Sonderfälle

"<all_urls>"

Stimmt mit jeder URL überein, die mit einem zulässigen Schema beginnt, einschließlich aller Muster, die unter Gültige Muster aufgeführt sind. Da die Überprüfung alle Hosts betrifft, kann die Überprüfung von Erweiterungen im Chrome Web Store länger dauern.

"file:///"

Ihre Erweiterung kann für lokale Dateien ausgeführt werden. Bei diesem Muster muss der Nutzer manuell Zugriff gewähren. In diesem Fall sind nicht zwei, sondern drei Schrägstriche erforderlich.

Localhost-URLs und IP-Adressen

Verwenden Sie http://localhost/*, um während der Entwicklung einen localhost-Port zuzuordnen. Geben Sie für IP-Adressen die Adresse sowie einen Platzhalter im Pfad an, z. B. http://127.0.0.1/*. Sie können auch http://*:*/* verwenden, um den lokalen Host, IP-Adressen und jeden Port abzugleichen.

Top-Level-Domain-Übereinstimmungsmuster

Chrome unterstützt keine Abgleichsmuster für Top-Level-Domains (TLD). Geben Sie Ihre Abgleichsmuster innerhalb der einzelnen TLDs an, wie in http://google.es/* und http://google.fr/*.

Beispielmuster

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

Stimmt mit jeder URL nach dem https-Schema überein.

https://*/foo*

Stimmt mit jeder URL nach dem https-Schema auf einem beliebigen Host überein, deren Pfad 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

Stimmt mit jeder URL nach dem https-Schema auf einem google.com-Host überein, dessen Pfad 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.