Ü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 Doppelpunkt gefolgt von einem 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:

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 den Zugriff manuell gewähren. Beachten Sie, dass in diesem Fall drei Schrägstriche und nicht zwei erforderlich sind.
Localhost-URLs und IP-Adressen
Verwenden Sie http://localhost/*, um während der Entwicklung mit einem beliebigen localhost-Port übereinzustimmen. Geben Sie für IP-Adressen die Adresse und ein Platzhalterzeichen 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
Chrome unterstützt keine Übereinstimmungsmuster für Top-Level-Domains (TLDs). 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/
Entspricht jeder URL, die das http-Schema 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/*
 entspricht jedem Localhost-Port.
*://mail.google.com/ oder *://mail.google.com/*
 Entspricht jeder URL, die mit http://mail.google.com oder https://mail.google.com beginnt.