Wzorce dopasowania

Wzór dopasowania to adres URL o tej strukturze, który służy do określania grupy adresów URL:

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

schemat: musi być jednym z tych elementów, oddzielonych od reszty wzorca dwukropkiem i podwójnym ukośnikiem (://):

  • http
  • https
  • symbol wieloznaczny *, który pasuje tylko do http lub https;
  • file

Informacje o wstrzykiwaniu skryptów treści do nieobsługiwanych schematów, takich jak about: i data:, znajdziesz w sekcji Wstrzykiwanie w powiązanych ramach.

host: nazwa hosta (www.example.com). * przed nazwą hosta, aby dopasować subdomeny (*.example.com), lub tylko symbol wieloznaczny *. – Jeśli w wzorze hosta używasz symbolu wieloznacznego, musi on być pierwszym lub jedynym znakiem, a po nim musi znajdować się kropka (.) lub ukośnik (/).

ścieżka: ścieżka adresu URL (/example). W przypadku uprawnień hosta ścieżka jest wymagana, ale jest ignorowana. Symbol wieloznaczny (/*) powinien być używany zgodnie z konwencją.

Rozszerzenia korzystają z wzorców dopasowania w różnych przypadkach użycia, m.in.:

Przypadki szczególne

"<all_urls>"
Pasuje do dowolnego adresu URL, który zaczyna się od dozwolonego schematu, w tym do dowolnego wzorca wymienionego w sekcji prawidłowe wzorce. Ponieważ dotyczy on wszystkich hostów, opinie w Chrome Web Store dotyczące rozszerzeń, które go używają, mogą być sprawdzane dłużej.
"file:///"
Zezwalanie na uruchamianie rozszerzenia na plikach lokalnych. W tym przypadku użytkownik musi ręcznie przyznawać dostęp. Pamiętaj, że w tym przypadku należy użyć 3 ukośników, a nie 2.
Adresy URL i adresy IP hosta lokalnego
Aby dopasować dowolny port localhost podczas tworzenia, użyj http://localhost/*. W przypadku adresów IP podaj adres wraz z symbolem wieloznacznym na ścieżce, np. http://127.0.0.1/*. Możesz też użyć http://*:*/*, aby dopasować localhost, adresy IP i dowolny port.
Wzorce dopasowania domeny najwyższego poziomu
Chrome nie obsługuje wzorów dopasowywania w przypadku domen najwyższego poziomu (TLD). Określ wzorce dopasowania w poszczególnych domenach najwyższego poziomu, np. http://google.es/* i http://google.fr/*.

Przykładowe wzory

https://*/* lub https://*/
Dopasowuje dowolny adres URL do schematu https.
https://*/foo*
Pasuje do każdego adresu URL w schemacie https na dowolnym hoście, którego ścieżka zaczyna się od foo. Przykłady dopasowań to https://example.com/foo/bar.html i https://www.google.com/foo.
https://*.google.com/foo*bar
Pasuje do każdego adresu URL korzystającego ze schematu https na hoście google.com, którego ścieżka zaczyna się od foo i kończy na bar. Przykłady dopasowań to https://www.google.com/foo/baz/bar i https://docs.google.com/foobar.
file:///foo*
Pasuje do każdego pliku lokalnego, którego ścieżka zaczyna się od foo. Przykłady dopasowań to file:///foo/bar.html i file:///foo.
http://127.0.0.1/* lub http://127.0.0.1/
Pasuje do dowolnego adresu URL, który używa schematu http i znajduje się na hoście 127.0.0.1. Przykłady dopasowań to http://127.0.0.1/ i http://127.0.0.1/foo/bar.html.
http://localhost/*
Pasuje do dowolnego portu localhost.
*://mail.google.com/ lub *://mail.google.com/*
Pasuje do każdego adresu URL, który zaczyna się od http://mail.google.com lub https://mail.google.com.