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

• Wstrzyknięcie skryptu treści.
• Zadeklaruj uprawnienia hosta, których niektóre interfejsy API Chrome wymagają oprócz własnych uprawnień.
• Przyznawanie dostępu do zasobów dostępnych w internecie.
• Zezwalanie na wysyłanie i odbieranie wiadomości przy użyciu klucza manifestu „externally_connectable.matches”.

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.