पैटर्न मैच करें

मैच पैटर्न, इस स्ट्रक्चर वाला यूआरएल होता है. इसका इस्तेमाल यूआरएल के ग्रुप को तय करने के लिए किया जाता है:

<scheme>://<host>:<port>/<path>

स्कीम: यह इनमें से कोई एक होनी चाहिए. इसे पैटर्न के बाकी हिस्से से अलग करने के लिए, कोलन के बाद डबल स्लैश (://) का इस्तेमाल करें:

• http
• https
• वाइल्डकार्ड *, जो सिर्फ़ http या https से मैच करता है
• file

about: और data: जैसे उन स्कीम में कॉन्टेंट स्क्रिप्ट इंजेक्ट करने के बारे में जानकारी पाएं जिनमें यह सुविधा काम नहीं करती. इसके लिए, मिलते-जुलते फ़्रेम में इंजेक्ट करना लेख पढ़ें.

host: यह एक होस्टनेम (www.example.com) होता है. सबडोमेन (*.example.com) से मेल खाने के लिए, होस्टनेम से पहले * या सिर्फ़ वाइल्डकार्ड *. - अगर होस्ट पैटर्न में वाइल्डकार्ड का इस्तेमाल किया जाता है, तो यह पहला या अकेला वर्ण होना चाहिए. इसके बाद, पीरियड (.) या फ़ॉरवर्ड स्लैश (/) होना चाहिए.

पोर्ट (ज़रूरी नहीं): मैच करने के लिए पोर्ट. डिफ़ॉल्ट रूप से, इसे वाइल्डकार्ड के तौर पर माना जाता है. इसका व्यवहार :* जैसा होता है.

path: यूआरएल पाथ (/example). होस्ट करने की अनुमतियों के लिए, पाथ ज़रूरी है, लेकिन इसे अनदेखा किया जाता है. वाइल्डकार्ड (/*) का इस्तेमाल, तय किए गए तरीके से किया जाना चाहिए.

एक्सटेंशन, मैच पैटर्न का इस्तेमाल कई तरह के कामों के लिए करते हैं. इनमें ये शामिल हैं:

• कॉन्टेंट स्क्रिप्ट इंजेक्ट की जा रही है.
• होस्ट करने की अनुमतियों का एलान करना. कुछ Chrome API को अपनी अनुमतियों के अलावा इनकी भी ज़रूरत होती है.
• वेब पर उपलब्ध संसाधनों का ऐक्सेस देना.
• "externally_connectable.matches" मेनिफ़ेस्ट कुंजी का इस्तेमाल करके, मैसेज भेजने और पाने की अनुमति देता है.

खास मामले

"<all_urls>"

यह अनुमति वाली किसी भी स्कीम से शुरू होने वाले यूआरएल से मेल खाता है. इसमें मान्य पैटर्न में शामिल कोई भी पैटर्न शामिल है. इसकी वजह यह है कि यह सभी होस्ट को प्रभावित करता है. इसलिए, इसका इस्तेमाल करने वाले एक्सटेंशन की Chrome Web Store पर समीक्षा होने में ज़्यादा समय लग सकता है.

"file:///"

इस अनुमति से, आपका एक्सटेंशन लोकल फ़ाइलों पर काम कर पाता है. इस पैटर्न में, उपयोगकर्ता को मैन्युअल तरीके से ऐक्सेस देना होता है. ध्यान दें कि इस मामले में दो नहीं, बल्कि तीन स्लैश की ज़रूरत होती है.

लोकल होस्ट के यूआरएल और आईपी पते

आईपी पते से मिलान करने के लिए, http://localhost/* या http://127.0.0.1/* का इस्तेमाल करें. मैच पैटर्न, सभी पोर्ट से मैच करते हैं. हालांकि, अगर कोई पोर्ट अलग से तय किया गया है, तो उससे मैच नहीं करते.

टॉप लेवल डोमेन से मेल खाने वाले पैटर्न

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 से शुरू होने वाले किसी भी यूआरएल से मेल खाता है.