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:
httphttps- Yalnızca
httpveyahttpsile 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 vefooile başlayan bir yola sahip tüm URL'leri eşleştirir. Eşleşmelere örnek olarakhttps://example.com/foo/bar.htmlvehttps://www.google.com/fooverilebilir. https://*.google.com/foo*barhttpsşemasını kullanan, google.com ana makinesinde bulunan,fooile başlayan vebarile biten bir path değerine sahip tüm URL'lerle eşleşir. Eşleşmelere örnek olarakhttps://www.google.com/foo/baz/barvehttps://docs.google.com/foobarverilebilir.file:///foo*- , yolu
fooile başlayan tüm yerel dosyalarla eşleşir. Eşleşmelere örnek olarakfile:///foo/bar.htmlvefile:///fooverilebilir. 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.htmlverilebilir. http://localhost/*- Herhangi bir yerel ana makine bağlantı noktasıyla eşleşir.
*://mail.google.com/veya*://mail.google.com/*- ,
http://mail.google.comveyahttps://mail.google.comile başlayan tüm URL'lerle eşleşir.