Eşleşme kalıbı, bir URL grubunu belirtmek için kullanılan ve aşağıdaki yapıya sahip bir URL'dir:
<scheme>://<host>:<port>/<path>
scheme: Aşağıdakilerden biri olmalı ve iki nokta üst üste işareti ile çift eğik çizgi (://) kullanılarak kalanın geri kalanından ayrılmalıdır:
httphttps- Yalnızca
httpveyahttpsile eşleşen bir joker karakter* file
about: ve data: gibi desteklenmeyen şemalara içerik komut dosyaları ekleme hakkında bilgi edinmek için İlgili çerçevelere ekleme bölümüne bakın.
host: Bir ana makine adı (www.example.com). Alt alan adlarıyla (*.example.com) eşleşmek için ana makine adından önce * 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 (.) ya da eğik çizgi (/) gelmelidir.
bağlantı noktası (isteğe bağlı): Eşleştirilecek bağlantı noktası. Bu, varsayılan olarak :* ile aynı davranışa sahip bir joker karakter olarak değerlendirilir.
path: Bir URL yolu (/example). Ana makine izinleri için yol gereklidir ancak yoksayılır. Joker karakter (/*) kurala uygun şekilde 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ı yerleştirme.
- Bazı Chrome API'lerinin kendi izinlerine ek olarak gerektirdiği ana makine izinlerini bildirme.
- Web'de erişilebilen kaynaklara erişim izni verme.
- "externally_connectable.matches" manifest anahtarını kullanarak mesaj gönderme ve alma işlemlerine izin verilir.
Özel durumlar
"<all_urls>"- Geçerli kalıplar altında listelenen tüm kalıplar dahil olmak üzere, izin verilen bir şemayla başlayan tüm URL'lerle eşleşir. Tüm ana makineleri etkilediği için, bu API'yi kullanan uzantılarla ilgili Chrome Web Mağazası yorumlarının incelenmesi daha uzun sürebilir.
"file:///"- Uzantınızın yerel dosyalarda çalışmasına izin verir. Bu kalıbın kullanılabilmesi için kullanıcının erişimi manuel olarak vermesi gerekir. Bu durumda iki değil üç eğik çizgi gerektiğini unutmayın.
- Localhost URL'leri ve IP adresleri
http://localhost/*veyahttp://127.0.0.1/*(bir IP adresiyle eşleşmek için) kullanın. Açık bir bağlantı noktası belirtilmediği sürece eşleşme kalıpları tüm bağlantı noktalarıyla eşleşir.- Üst düzey alan eşleşme kalıpları
- Chrome, üst düzey alanlar (TLD) için eşleşme kalıplarını desteklemez.
http://google.es/*vehttp://google.fr/*örneklerinde olduğu gibi, eşleşme kalıplarınızı tek tek TLD'ler içinde belirtin.
Örnek kalıplar
https://*/*veyahttps://*/httpsşemasını kullanan tüm URL'lerle eşleşir.https://*/foo*fooile başlayan bir yola sahip, herhangi bir ana makinedehttpsşemasını kullanan tüm URL'lerle eşleşir.https://example.com/foo/bar.htmlvehttps://www.google.com/foo, eşleşme örnekleridir.https://*.google.com/foo*bar- google.com ana makinesinde,
httpsşemasını kullanan,fooile başlayıpbarile biten bir yola sahip tüm URL'lerle eşleşir.https://www.google.com/foo/baz/barvehttps://docs.google.com/foobar, eşleşme örnekleridir. file:///foo*- Yolu
fooile başlayan tüm yerel dosyalarla eşleşir.file:///foo/bar.htmlvefile:///foo, eşleşme örnekleridir. 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.http://127.0.0.1/vehttp://127.0.0.1/foo/bar.html, eşleşme örnekleridir. http://localhost/*- Tüm localhost bağlantı noktaları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.