Übereinstimmungsmuster

Ein Übereinstimmungsmuster ist eine URL mit der folgenden Struktur, mit der eine Gruppe von URLs angegeben wird:

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

scheme: Muss einer der folgenden Werte sein, der durch einen Doppelpunkt gefolgt von zwei Schrägstrichen (://) vom Rest des Musters getrennt wird:

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

Informationen zum Einfügen von Inhaltsscripts in nicht unterstützte Schemas wie about: und data: finden Sie unter In verwandte Frames einfügen.

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

port (optional): Port, der übereinstimmen soll. Standardmäßig wird dies als Platzhalter mit demselben Verhalten wie :* behandelt.

path: Ein URL-Pfad (/example). Für Hostberechtigungen ist der Pfad erforderlich, wird aber ignoriert. Der Platzhalter (/*) sollte standardmäßig verwendet werden.

Erweiterungen verwenden Musterabgleich in einer Vielzahl von Anwendungsfällen, darunter:

Sonderfälle

"<all_urls>"
Entspricht jeder URL, die mit einem zulässigen Schema beginnt, einschließlich aller Muster, die unter Gültige Muster aufgeführt sind. Da es sich auf alle Hosts auswirkt, kann die Überprüfung von Chrome Web Store-Rezensionen für Erweiterungen, die es verwenden, länger dauern.
"file:///"
Ermöglicht Ihrer Erweiterung, auf lokale Dateien zuzugreifen. 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/* oder http://127.0.0.1/*, um eine IP-Adresse abzugleichen. Muster für den Abgleich stimmen mit allen Ports überein, sofern kein expliziter Port angegeben ist.
Muster für übereinstimmende Top-Level-Domains
Chrome unterstützt keine Mustervergleichsfunktionen für Top-Level-Domains (TLDs). Geben Sie Ihre Muster für den Abgleich innerhalb der einzelnen TLDs an, wie in http://google.es/* und http://google.fr/*.

Beispielmuster

https://*/* oder https://*/
Entspricht jeder URL, die das https-Schema verwendet.
https://*/foo*
Entspricht jeder URL, die das https-Schema auf einem beliebigen Host verwendet und 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
Entspricht jeder URL, die das https-Schema auf einem google.com-Host verwendet und deren 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*
Entspricht jeder lokalen Datei, 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.