Pola pencocokan

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 dengan http atau https
• 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 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 TLD individual, seperti dalam http://google.es/* dan http://google.fr/*.

Contoh pola

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

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 dengan foo. Contoh kecocokan antara lain 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 antara lain https://www.google.com/foo/baz/bar dan https://docs.google.com/foobar.

file:///foo*

Cocok dengan file lokal apa pun yang jalurnya diawali dengan foo. Contoh kecocokan antara lain 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 antara lain 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.