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ı ve desenin geri kalanı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
İçerik komut dosyalarını about:
ve data:
gibi desteklenmeyen şemalara yerleştirme hakkında bilgi için İlgili çerçevelere ekleme bölümüne bakın.
ana makine: Bir ana makine adı (www.example.com
). Alt alan adlarıyla eşleştirmek için ana makine adından önce *
işareti (*.example.com
) veya yalnızca *
joker karakteri.
- 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'den erişilebilen kaynaklara erişim 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 kalıplar da dahil olmak üzere, izin verilen bir şema ile başlayan herhangi bir URL'yle 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ı incelemeleri 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ını eşleştirmek 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şmesi 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 olan 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 ana makine 127.0.0.1 üzerinde bulunan herhangi bir URL ile 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 herhangi bir URL ile eşleşir.