Eşleşme kalıbı, bir URL grubunu belirtmek için kullanılan aşağıdaki yapıya sahip bir URL'dir:
<scheme>://<host>/<path>
scheme: Aşağıdakilerden biri olmalıdır ve kalıbın geri kalanından iki nokta üst üste işareti ve ardından çift eğik çizgi (://
) kullanılarak ayrılmalıdır:
http
https
- Yalnızca
http
veyahttps
ile eşleşen bir joker karakter*
file
about:
ve data:
gibi desteklenmeyen şemalara içerik komut dosyası yerleştirme hakkında bilgi edinmek için İlgili çerçevelere içerik yerleştirme başlıklı makaleyi inceleyin.
host: Ana makine adı (www.example.com
). Alt alan adlarını (*.example.com
) eşleştirmek için ana makine adından önce bir *
veya yalnızca bir joker karakter *
.
- Ana makine kalıbında joker karakter kullanıyorsanız bu karakter ilk veya tek karakter olmalı ve ardından nokta (.
) veya eğik çizgi (/
) gelmelidir.
path: URL yolu (/example
). Ana makine izinleri için yol gereklidir ancak yoksayılır. Joker karakter (/*
) kural olarak kullanılmalıdır.
Uzantılar, aşağıdakiler de dahil olmak üzere çeşitli kullanım alanlarında eşleşme kalıplarını kullanır:
- İçerik komut dosyası ekleme.
- Bazı Chrome API'lerinin kendi izinlerine ek olarak ihtiyaç duyduğu ana makine izinlerini beyan etme.
- Web'e erişilebilen kaynaklara erişim izni verme.
- "externally_connectable.matches" manifest anahtarı kullanılarak mesaj gönderip alınmasına izin verme.
Özel durumlar
"<all_urls>"
- , geçerli kalıplar altında listelenen tüm kalıplar dahil olmak üzere izin verilen bir şema ile başlayan tüm URL'lerle eşleşir. Tüm barındırıcıları etkilediği için bu özelliği kullanan uzantıların Chrome Web Mağazası yorumları daha uzun sürebilir.
"file:///"
- Uzantılarınızın yerel dosyalarda çalışmasına olanak tanır. Bu kalıpta kullanıcının manuel olarak erişim izni vermesi gerekir. Bu durumda iki değil üç eğik çizgi gerektiğini unutmayın.
- Yerel ana makine URL'leri ve IP adresleri
- Geliştirme sırasında herhangi bir yerel ana makine bağlantı noktasıyla eşleştirme yapmak için
http://localhost/*
değerini kullanın. IP adresleri için adresin yanı sıra yolda bir joker karakter belirtin (http://127.0.0.1/*
gibi). Yerel ana makine, IP adresleri ve herhangi bir bağlantı noktasıyla eşleştirme yapmak içinhttp://*:*/*
değerini de kullanabilirsiniz. - Üst düzey alan eşleşme kalıpları
- Chrome, üst düzey alanlar (TLD) için eşleme kalıplarını desteklemez. Eşleme kalıplarınızı ayrı TLD'lerde belirtin (
http://google.es/*
vehttp://google.fr/*
gibi).
Örnek desenler
https://*/*
veyahttps://*/
https
şemasını kullanan tüm URL'lerle eşleşir.https://*/foo*
- ,
https
şemasını kullanan vefoo
ile başlayan bir yola sahip tüm URL'leri eşleştirir. Eşleşmelere örnek olarakhttps://example.com/foo/bar.html
vehttps://www.google.com/foo
verilebilir. https://*.google.com/foo*bar
https
şemasını kullanan, google.com ana makinesinde bulunan,foo
ile başlayan vebar
ile biten bir path değerine sahip tüm URL'lerle eşleşir. Eşleşmelere örnek olarakhttps://www.google.com/foo/baz/bar
vehttps://docs.google.com/foobar
verilebilir.file:///foo*
- , yolu
foo
ile başlayan tüm yerel dosyalarla eşleşir. Eşleşmelere örnek olarakfile:///foo/bar.html
vefile:///foo
verilebilir. http://127.0.0.1/*
veyahttp://127.0.0.1/
- ,
http
şemasını kullanan ve 127.0.0.1 ana makinesinde bulunan tüm URL'lerle eşleşir. Eşleşmelere örnek olarakhttp://127.0.0.1/
vehttp://127.0.0.1/foo/bar.html
verilebilir. http://localhost/*
- Herhangi bir yerel ana makine bağlantı noktasıyla eşleşir.
*://mail.google.com/
veya*://mail.google.com/*
- ,
http://mail.google.com
veyahttps://mail.google.com
ile başlayan tüm URL'lerle eşleşir.