Pola pencocokan

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

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

skema: Harus berupa salah satu dari berikut ini, yang dipisahkan dari pola lainnya menggunakan 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 berupa 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 sesuai dengan konvensi.

Ekstensi menggunakan pola pencocokan dalam berbagai kasus penggunaan, termasuk:

Kasus khusus

"<all_urls>"
Cocok dengan URL apa pun yang dimulai dengan skema yang diizinkan, termasuk pola apa pun yang tercantum dalam 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 apa pun 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 dalam TLD individual Anda, seperti di 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.