Ta strona została przetłumaczona przez Cloud Translation API.

Wzorce dopasowania

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

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

scheme: musi być jednym z tych elementów i oddzielić go od pozostałej części wzorca podwójnym ukośnikiem (//):

http
https
Symbol wieloznaczny *, który pasuje tylko do http lub https
file

Informacje na temat wstrzykiwania skryptów treści do nieobsługiwanych schematów, takich jak about: i data:, znajdziesz w artykule Wstawianie w powiązanych ramkach.

host: nazwa hosta (www.example.com). * przed nazwą hosta, która pasuje do subdomen (*.example.com) lub symbol wieloznaczny *. – Jeśli we wzorcu hosta używasz symbolu wieloznacznego, musi on być pierwszym lub jedynym znakiem, po którym musi występować kropka (.) lub ukośnik (/).

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ą.

Rozszerzenia korzystają z wzorców dopasowania w różnych przypadkach użycia, takich jak:

Wstrzykuję skrypt treści.
Zadeklarowanie uprawnień hosta, których niektóre interfejsy API Chrome wymagają oprócz własnych uprawnień.
Przyznawanie dostępu do zasobów dostępnych z internetu.
Zezwalaj na wysyłanie i odbieranie wiadomości przy użyciu klucza manifestu "externally_connectable.matches".

Przypadki szczególne

"<all_urls>": Pasuje do wszystkich adresów URL, które zaczynają się od dozwolonego schematu, w tym do wszelkich wzorców wymienionych w sekcji prawidłowe wzorce. Ma to wpływ na wszystkie hosty, dlatego sprawdzanie w sklepie Chrome Web Store rozszerzeń, które z niego korzystają, może potrwać dłużej.
"file:///": Umożliwia uruchamianie rozszerzenia w plikach lokalnych. Ten wzorzec wymaga od użytkownika ręcznego przyznania dostępu. Pamiętaj, że w tym przypadku trzeba użyć 3 ukośników, a nie dwóch.
Adresy URL i adresy IP hosta lokalnego: Aby dopasować dowolny port lokalnego hosta podczas programowania, użyj parametru http://localhost/*. W przypadku adresów IP podaj adres i symbol wieloznaczny w ścieżce, np. http://127.0.0.1/*. Przy użyciu zasady http://*:*/* możesz też dopasować hosta lokalnego, adresy IP i dowolny port.
Wzorce dopasowania domeny najwyższego poziomu: Chrome nie obsługuje wzorców dopasowania w domenach 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 wzorce

https://*/* lub https://*/: Pasuje do dowolnych adresów URL przy użyciu schematu https.
https://*/foo*: Pasuje do wszystkich adresów URL przy użyciu schematu https na dowolnym hoście, przy użyciu ścieżki rozpoczynającej się od foo. Przykładowe dopasowania: https://example.com/foo/bar.html i https://www.google.com/foo.
https://*.google.com/foo*bar: Pasuje do wszystkich adresów URL przy użyciu schematu https na hoście google.com, których ścieżka zaczyna się od foo i kończy na bar. Przykładowe dopasowania: https://www.google.com/foo/baz/bar i https://docs.google.com/foobar.
file:///foo*: Pasuje do wszystkich plików lokalnych, których ścieżka zaczyna się od foo. Przykładowe dopasowania: file:///foo/bar.html i file:///foo.
http://127.0.0.1/* lub http://127.0.0.1/: Pasuje do wszystkich adresów URL, które używają schematu http i znajdują się na hoście 127.0.0.1. Przykładowe dopasowania: http://127.0.0.1/ i http://127.0.0.1/foo/bar.html.
http://localhost/*: Pasuje do dowolnego portu lokalnego hosta.
*://mail.google.com/ lub *://mail.google.com/*: Pasuje do wszystkich adresów URL, które zaczynają się od http://mail.google.com lub https://mail.google.com.