Pola pencocokan

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

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

scheme: Harus salah satu dari yang berikut, 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 mengetahui informasi tentang cara menyisipkan skrip konten ke dalam skema yang tidak didukung, seperti about: dan data:, lihat Menyisipkan di 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 tersebut harus menjadi karakter pertama atau satu-satunya, dan harus diikuti dengan titik (.) atau garis miring (/).

port (opsional): Port yang akan dicocokkan. Secara default, port ini diperlakukan sebagai karakter pengganti dengan perilaku yang sama seperti :*.

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

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

Kasus khusus

"<all_urls>"
Cocok dengan URL apa pun yang dimulai dengan skema yang diizinkan, termasuk pola apa pun yang tercantum di bagian pola valid. Karena memengaruhi semua host, peninjauan Chrome Web Store untuk ekstensi yang menggunakannya mungkin memerlukan waktu lebih lama.
"file:///"
Mengizinkan ekstensi Anda berjalan di file lokal. Pola ini mengharuskan pengguna memberikan akses secara manual grant access. Perhatikan bahwa kasus ini memerlukan tiga garis miring, bukan dua.
URL dan alamat IP localhost
Gunakan http://localhost/*, atau http://127.0.0.1/* (untuk mencocokkan alamat IP). Pola kecocokan cocok dengan semua port kecuali jika port eksplisit ditentukan.
Pola kecocokan domain Level Teratas
Chrome tidak mendukung pola kecocokan untuk domain Level Teratas (TLD). Tentukan pola kecocokan Anda dalam masing-masing TLD, seperti dalam http://google.es/* dan http://google.fr/*.

Pola contoh

https://*/* atau https://*/
Cocok dengan URL apa pun yang menggunakan skema https.
https://*/foo*
Cocok dengan URL apa pun yang menggunakan skema https, di host mana pun, dengan jalur yang dimulai dengan foo. Contoh kecocokan mencakup https://example.com/foo/bar.html dan https://www.google.com/foo.
https://*.google.com/foo*bar
Cocok dengan URL apa pun yang menggunakan skema https, di host google.com, dengan jalur yang dimulai 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 dimulai dengan http://mail.google.com atau https://mail.google.com.