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>

scheme: musi być jedną z tych wartości, oddzieloną od reszty wzorca 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 (/).

path: ścieżka adresu URL (/example). W przypadku uprawnień hosta ta ś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, między innymi:

• Wstrzyknięcie skryptu treści.
• Deklarowanie uprawnień hosta, których oprócz własnych uprawnień wymagają niektóre interfejsy API Chrome.
• Przyznaje dostęp do zasobów dostępnych przez internet.
• Zezwala 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 prawidłowych wzorcach. Dotyczy to wszystkich hostów, dlatego w sklepie Chrome Web Store sprawdzanie rozszerzeń, które go używają, może potrwać dłużej.

"file:///"

Umożliwia uruchamianie rozszerzenia w 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 wzorce

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 dopasowania: https://example.com/foo/bar.html i https://www.google.com/foo.

https://*.google.com/foo*bar

Pasuje do każdego adresu URL w schemacie https na hoście google.com, którego ścieżka zaczyna się od foo, a 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 dopasowania: 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.