होस्ट की अनुमतियां और कॉन्टेंट स्क्रिप्ट मैचिंग, मैच पैटर्न से तय किए गए यूआरएल के सेट पर आधारित होती हैं. मैच पैटर्न एक ऐसा यूआरएल है जो अनुमति वाली स्कीम (http
, https
,
file
या ftp
) से शुरू होता है. इसमें '*
' वर्ण हो सकते हैं. खास पैटर्न <all_urls>
ऐसे किसी भी यूआरएल से मेल खाता है जो अनुमति वाली स्कीम से शुरू होता है. मैच पैटर्न के तीन हिस्से होते हैं:
स्कीम—उदाहरण के लिए,
http
याfile
या*
ध्यान दें:file
यूआरएल को ऐक्सेस करने की सुविधा अपने-आप नहीं मिलती. उपयोगकर्ता को एक्सटेंशन मैनेजमेंट पेज पर जाना होगा. साथ ही, अनुरोध करने वाले हर एक्सटेंशन के लिए,file
के ऐक्सेस के लिए ऑप्ट इन करना होगा.होस्ट—उदाहरण के लिए,
www.google.com
या*.google.com
या*
. अगर स्कीमfile
है, तो होस्ट वाला हिस्सा नहीं होगाpath—उदाहरण के लिए,
/*
,/foo*
या/foo/bar
. पाथ का होस्ट की अनुमति में मौजूद होना ज़रूरी है, लेकिन इसे हमेशा/*
के तौर पर माना जाता है.
इसका बुनियादी सिंटैक्स यहां दिया गया है:
<url-pattern> := <scheme>://<host><path>
<scheme> := '*' | 'http' | 'https' | 'file' | 'ftp' | 'urn'
<host> := '*' | '*.' <any char except '/' and '*'>+
<path> := '/' <any chars>
'*
' का मतलब इस बात पर निर्भर करता है कि यह स्कीम, होस्ट या पाथ वाले हिस्से में है या नहीं. अगर
स्कीम *
है, तो वह http
या https
से मेल खाती है और file
, ftp
या urn
नहीं है. अगर
होस्ट सिर्फ़ *
है, तो यह किसी भी होस्ट से मेल खाता है. अगर होस्ट *._hostname_
है, तो यह बताए गए होस्ट या उसके किसी भी सबडोमेन से मेल खाता है. पाथ सेक्शन में, हर '*
' में 0 या इससे ज़्यादा वर्ण हैं. यहां दी गई टेबल में कुछ मान्य पैटर्न दिखाए गए हैं.
पैटर्न | यह क्या करता है | मिलते-जुलते यूआरएल के उदाहरण |
---|---|---|
http://*/* | http स्कीम का इस्तेमाल करने वाले किसी भी यूआरएल से मेल खाता है | http://www.google.com/ http://example.org/foo/bar.html |
http://*/foo* | किसी भी होस्ट पर http स्कीम का इस्तेमाल करने वाले किसी भी यूआरएल से तब तक मेल खाता है, जब तक पाथ /foo से शुरू होता है | http://example.com/foo/bar.html http://www.google.com/foo |
https://*.google.com/foo*bar | https स्कीम का इस्तेमाल करने वाले किसी भी यूआरएल से मेल खाता है. यह google.com होस्ट (जैसे www.google.com, docs.google.com या google.com) पर है. हालांकि, इसके लिए ज़रूरी है कि पाथ /foo से शुरू होता हो और bar पर खत्म होता हो | https://www.google.com/foo/baz/bar https://docs.google.com/foobar |
http://example.org/foo/bar.html | बताए गए यूआरएल से मेल खाता है | http://example.org/foo/bar.html |
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/foo/bar.html |
*://mail.google.com/* | http://mail.google.com या https://mail.google.com से शुरू होने वाले किसी भी यूआरएल से मेल खाता है. | http://mail.google.com/foo/baz/bar https://mail.google.com/foobar |
urn:* | urn: से शुरू होने वाले किसी भी यूआरएल से मेल खाता है. | urn:uuid:54723bea-c94e-480e-80c8-a69846c3f582 urn:uuid:cfa40aff-07df-45b2-9f95-e023bcf4a6da |
<all_urls> | अनुमति वाली स्कीम का इस्तेमाल करने वाले किसी भी यूआरएल से मेल खाता है. (अनुमति वाली स्कीम की सूची के लिए इस सेक्शन की शुरुआत में देखें.) | http://example.org/foo/bar.html file:///bar/baz.html |
यहां अमान्य पैटर्न से मेल खाने वाले कुछ उदाहरण दिए गए हैं:
खराब पैटर्न | यह बुरा क्यों है |
---|---|
http://www.google.com | कोई पाथ नहीं है |
http://*foo/bar | होस्ट में मौजूद '*' के बाद, सिर्फ़ '.' या '/' का इस्तेमाल किया जा सकता है |
http://foo.*.bar/baz | अगर host में '*' है, तो यह पहला वर्ण होना चाहिए |
http:/bar | स्कीम सेपरेटर ("/" "//") होना चाहिए |
foo://* | अमान्य स्कीम |
कुछ स्कीम का इस्तेमाल सभी तरह से नहीं किया जा सकता.