मैच पैटर्न, नीचे दिए गए स्ट्रक्चर वाला यूआरएल होता है. इसका इस्तेमाल यूआरएल का ग्रुप तय करने के लिए किया जाता है:
<scheme>://<host>/<path>
स्कीम: यह इनमें से कोई एक होनी चाहिए और उसे डबल स्लैश (//
) का इस्तेमाल करके, बाकी पैटर्न से अलग करना चाहिए:
http
https
- कोई वाइल्डकार्ड
*
, जो सिर्फ़http
याhttps
से मेल खाता है file
about:
और data:
जैसी काम न करने वाली स्कीम में कॉन्टेंट स्क्रिप्ट को इंजेक्ट करने के बारे में जानकारी के लिए, मिलते-जुलते फ़्रेम में इंजेक्ट करना देखें.
होस्ट: एक होस्टनेम (www.example.com
). सबडोमेन (*.example.com
) से मैच करने के लिए, होस्टनेम से पहले *
या सिर्फ़ वाइल्डकार्ड *
.
- अगर होस्ट पैटर्न में वाइल्डकार्ड का इस्तेमाल किया जाता है, तो यह पहला या इकलौता वर्ण होना चाहिए. साथ ही, इसके बाद पीरियड (.
) या फ़ॉरवर्ड स्लैश (/
) होना चाहिए.
पाथ: यूआरएल पाथ (/example
). होस्ट की अनुमतियों के लिए पाथ ज़रूरी है, लेकिन इसे अनदेखा किया गया है. वाइल्डकार्ड (/*
) का इस्तेमाल कंवेंशन के हिसाब से किया जाना चाहिए.
एक्सटेंशन, मैच पैटर्न का इस्तेमाल कई तरह के मामलों में करते हैं. इनमें ये शामिल हैं:
- कॉन्टेंट स्क्रिप्ट इंजेक्ट की जा रही है.
- होस्ट की अनुमतियों का एलान करना. ये वे अनुमतियां हैं जो कुछ Chrome API को उनकी अनुमतियों के साथ-साथ ज़रूरी हैं.
- वेब पर ऐक्सेस करने लायक संसाधनों का ऐक्सेस देना.
- "externally_connectable.matches" मेनिफ़ेस्ट कुंजी का इस्तेमाल करके, मैसेज भेजने और पाने की अनुमति दें.
खास मामले
"<all_urls>"
- ऐसे किसी भी यूआरएल से मेल खाता है जो मान्य स्कीम से शुरू होता है. इसमें मान्य पैटर्न में दिया गया कोई भी पैटर्न शामिल है. इसका असर सभी होस्ट पर पड़ता है. इसलिए, 'Chrome वेब स्टोर' का इस्तेमाल करने वाले एक्सटेंशन की समीक्षा करने में ज़्यादा समय लग सकता है.
"file:///"
- इससे आपके एक्सटेंशन को लोकल फ़ाइलों पर चलने की सुविधा मिलती है. इस पैटर्न के लिए उपयोगकर्ता को मैन्युअल रूप से ऐक्सेस देना ज़रूरी है. ध्यान दें कि इस मामले में दो के बजाय, तीन स्लैश की ज़रूरत होती है.
- लोकलहोस्ट के यूआरएल और आईपी पते
- डेवलपमेंट के दौरान किसी भी लोकलहोस्ट पोर्ट से मिलान करने के लिए,
http://localhost/*
का इस्तेमाल करें. आईपी पतों के लिए, पाथ में पते के साथ एक वाइल्डकार्ड डालें, जैसे किhttp://127.0.0.1/*
. लोकलहोस्ट, आईपी पतों, और किसी भी पोर्ट का मिलान करने के लिए,http://*:*/*
का इस्तेमाल भी किया जा सकता है. - टॉप लेवल डोमेन के मैच के पैटर्न
- Chrome पर टॉप लेवल डोमेन (टीएलडी) के लिए, मैच पैटर्न का इस्तेमाल नहीं किया जा सकता. अलग-अलग टीएलडी में अपने मैच पैटर्न के बारे में बताएं, जैसे कि
http://google.es/*
औरhttp://google.fr/*
में.
पैटर्न के उदाहरण
https://*/*
याhttps://*/
https
स्कीम का इस्तेमाल करने वाले किसी भी यूआरएल से मैच करता है.https://*/foo*
https
स्कीम का इस्तेमाल करके, किसी भी होस्ट पर मौजूद यूआरएल कोfoo
से शुरू होने वाले पाथ के साथ मैच करता है. मिलान के उदाहरणों मेंhttps://example.com/foo/bar.html
औरhttps://www.google.com/foo
शामिल हैं.https://*.google.com/foo*bar
- यह google.com होस्ट पर,
https
स्कीम का इस्तेमाल करके बनाए गए ऐसे किसी भी यूआरएल को मैच करता है जिसका पाथfoo
से शुरू होता है औरbar
पर खत्म होता है. मिलान के उदाहरणों मेंhttps://www.google.com/foo/baz/bar
औरhttps://docs.google.com/foobar
शामिल हैं. file:///foo*
- ऐसी किसी भी लोकल फ़ाइल से मैच करता है जिसका पाथ
foo
से शुरू होता है. मिलान के उदाहरणों मेंfile:///foo/bar.html
औरfile:///foo
शामिल हैं. http://127.0.0.1/*
याhttp://127.0.0.1/
- ऐसे किसी भी यूआरएल से मेल खाता है जो
http
स्कीम का इस्तेमाल करता है और जो होस्ट 127.0.0.1 पर है. मिलान के उदाहरणों मेंhttp://127.0.0.1/
औरhttp://127.0.0.1/foo/bar.html
शामिल हैं. http://localhost/*
- किसी भी लोकलहोस्ट पोर्ट से मेल खाता है.
*://mail.google.com/
या*://mail.google.com/*
http://mail.google.com
याhttps://mail.google.com
से शुरू होने वाले किसी भी यूआरएल से मेल खाता है.