Pola pencocokan

Pola pencocokan adalah URL dengan struktur berikut, yang digunakan untuk menentukan grup URL:

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

skema: Harus berupa salah satu dari berikut ini, yang dipisahkan dari pola lainnya menggunakan titik dua, diikuti dengan garis miring ganda (://):

• http
• https
• Karakter pengganti *, yang hanya cocok dengan http atau https
• file

Untuk informasi tentang cara memasukkan skrip konten ke dalam skema yang tidak didukung, seperti about: dan data:, lihat Memasukkan ke dalam frame terkait.

host: Nama host (www.example.com). * sebelum nama host untuk mencocokkan subdomain (*.example.com), atau hanya karakter pengganti *. - Jika Anda menggunakan karakter pengganti dalam pola host, karakter pengganti tersebut harus menjadi karakter pertama atau satu-satunya, dan harus diikuti dengan titik (.) atau garis miring (/).

path: Jalur URL (/example). Untuk izin host, jalur diperlukan, tetapi diabaikan. Karakter pengganti (/*) harus digunakan sesuai dengan konvensi.

Ekstensi menggunakan pola pencocokan dalam berbagai kasus penggunaan, termasuk yang berikut ini:

• Memasukkan skrip konten.
• Mendeklarasikan izin host yang diperlukan beberapa Chrome API selain izinnya sendiri.
• Memberikan akses ke resource yang dapat diakses web.
• Mengizinkan pengiriman dan penerimaan pesan menggunakan kunci manifes "externally_connectable.matches".

Kasus khusus

"<all_urls>"

Cocok dengan URL apa pun yang diawali dengan skema yang diizinkan, termasuk pola apa pun yang tercantum di bagian pola yang valid. Karena memengaruhi semua host, tinjauan Chrome Web Store untuk ekstensi yang menggunakannya mungkin memerlukan waktu lebih lama.

"file:///"

Memungkinkan ekstensi Anda berjalan di file lokal. Pola ini mengharuskan pengguna untuk memberikan akses secara manual. Perhatikan bahwa kasus ini memerlukan tiga garis miring, bukan dua.

URL dan alamat IP localhost

Untuk mencocokkan port localhost selama pengembangan, gunakan http://localhost/*. Untuk alamat IP, tentukan alamat beserta karakter pengganti di jalur, seperti di http://127.0.0.1/*. Anda juga dapat menggunakan http://*:*/* untuk mencocokkan localhost, alamat IP, dan port apa pun.

Pola pencocokan domain Level Teratas

Chrome tidak mendukung pola pencocokan untuk domain Level teratas (TLD). Tentukan pola pencocokan Anda dalam setiap TLD, seperti dalam http://google.es/* dan http://google.fr/*.

Contoh pola

https://*/* atau https://*/

Cocok dengan URL apa pun yang menggunakan skema https.

https://*/foo*

Mencocokkan URL apa pun yang menggunakan skema https, di host mana pun, dengan jalur yang diawali dengan foo. Contoh kecocokan mencakup https://example.com/foo/bar.html dan https://www.google.com/foo.

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

Mencocokkan URL apa pun yang menggunakan skema https, di host google.com, dengan jalur yang diawali dengan foo dan diakhiri dengan bar. Contoh kecocokan mencakup https://www.google.com/foo/baz/bar dan https://docs.google.com/foobar.

file:///foo*

Cocok dengan file lokal apa pun yang jalurnya dimulai dengan foo. Contoh kecocokan mencakup file:///foo/bar.html dan file:///foo.

http://127.0.0.1/* atau http://127.0.0.1/

Cocok dengan URL apa pun yang menggunakan skema http dan berada di host 127.0.0.1. Contoh kecocokan mencakup http://127.0.0.1/ dan http://127.0.0.1/foo/bar.html.

http://localhost/*

Cocok dengan port localhost apa pun.

*://mail.google.com/ atau *://mail.google.com/*

Cocok dengan URL apa pun yang diawali dengan http://mail.google.com atau https://mail.google.com.