Wzorce dopasowania

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

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

scheme: musi być jednym z tych elementów, oddzielonym od reszty wzorca dwukropkiem i dwoma ukośnikami (://):

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

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

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

port (opcjonalnie): port, który ma być dopasowany. Domyślnie jest on traktowany jako symbol wieloznaczny o takim samym działaniu jak :*.

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

Wzorce dopasowania są używane w rozszerzeniach w różnych przypadkach, m.in.:

Przypadki szczególne

"<all_urls>"
Pasuje do każdego adresu URL, który zaczyna się od dozwolonego schematu, w tym do każdego wzorca wymienionego w sekcji prawidłowe wzorce. Ponieważ wpływa na wszystkich hostów, sprawdzanie opinii w Chrome Web Store dotyczących rozszerzeń, które go używają, może potrwać dłużej.
"file:///"
Umożliwia rozszerzeniu uruchamianie się na plikach lokalnych. Ten wzorzec wymaga, aby użytkownik ręcznie przyznał dostęp. Pamiętaj, że w tym przypadku wymagane są 3 ukośniki, a nie 2.
Adresy URL i adresy IP hosta lokalnego
Użyj znaku http://localhost/* lub http://127.0.0.1/* (aby dopasować adres IP). Wzorce dopasowania pasują do wszystkich portów, chyba że określono konkretny port.
Wzorce dopasowania domeny najwyższego poziomu
Chrome nie obsługuje wzorców dopasowania dla domen najwyższego poziomu. Określ wzorce dopasowania w poszczególnych domenach najwyższego poziomu, np. http://google.es/* i http://google.fr/*.

Przykładowe wzorce

https://*/* lub https://*/
Pasuje do każdego adresu URL, który korzysta ze schematu https.
https://*/foo*
Pasuje do każdego adresu URL, który korzysta ze schematu https na dowolnym hoście i ma ścieżkę zaczynającą 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, który korzysta ze schematu https, jest hostowany w domenie google.com, a jego ś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 każdego adresu URL, który korzysta ze 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/*
Dopasowuje każdy adres URL, który zaczyna się od http://mail.google.com lub https://mail.google.com.