Pola kecocokan adalah URL dengan struktur berikut, yang digunakan untuk menentukan sekumpulan URL:
<scheme>://<host>/<path>
skema: Harus berupa salah satu dari yang berikut ini, dipisahkan dari pola lainnya yang menggunakan garis miring ganda (//
):
http
https
- Karakter pengganti
*
, yang hanya cocok denganhttp
atauhttps
file
Untuk mengetahui informasi tentang cara memasukkan skrip konten ke dalam skema yang tidak didukung, seperti about:
dan data:
, lihat Memasukkan dalam frame terkait.
host: Nama host (www.example.com
). *
sebelum nama host agar cocok dengan subdomain (*.example.com
), atau hanya *
karakter pengganti.
- Jika Anda menggunakan karakter pengganti di pola host, karakter tersebut harus merupakan karakter pertama atau satu-satunya, dan harus diikuti dengan titik (.
) atau garis miring (/
).
path: Jalur URL (/example
). Untuk izin host, jalur wajib ada tetapi diabaikan. Karakter pengganti (/*
) harus digunakan berdasarkan konvensi.
Ekstensi menggunakan pola pencocokan dalam berbagai kasus penggunaan, termasuk:
- 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 semua URL yang diawali dengan skema yang diizinkan, termasuk pola yang tercantum dalam pola yang valid. Karena hal ini memengaruhi semua host, peninjauan 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 Localhost dan alamat IP
- Untuk mencocokkan port localhost selama pengembangan, gunakan
http://localhost/*
. Untuk alamat IP, tentukan alamat dan karakter pengganti di jalur, seperti dihttp://127.0.0.1/*
. Anda juga dapat menggunakanhttp://*:*/*
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 TLD individual, seperti dalam
http://google.es/*
danhttp://google.fr/*
.
Contoh pola
https://*/*
atauhttps://*/
- Cocok dengan URL apa pun menggunakan skema
https
. https://*/foo*
- Mencocokkan URL apa pun yang menggunakan skema
https
, di host mana pun, dengan jalur yang diawali denganfoo
. Contoh kecocokan antara lainhttps://example.com/foo/bar.html
danhttps://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 denganfoo
dan diakhiri denganbar
. Contoh kecocokan antara lainhttps://www.google.com/foo/baz/bar
danhttps://docs.google.com/foobar
. file:///foo*
- Cocok dengan file lokal apa pun yang jalurnya diawali dengan
foo
. Contoh kecocokan antara lainfile:///foo/bar.html
danfile:///foo
. http://127.0.0.1/*
atauhttp://127.0.0.1/
- Cocok dengan URL apa pun yang menggunakan skema
http
dan berada di host 127.0.0.1. Contoh kecocokan antara lainhttp://127.0.0.1/
danhttp://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
atauhttps://mail.google.com
.