chrome.declarativeContent

ब्यौरा

अनुमतियां

कॉन्सेप्ट और इस्तेमाल

Declarative Content API की मदद से, किसी वेब पेज के यूआरएल या पेज पर मौजूद किसी एलिमेंट से मैच करने वाले सीएसएस सिलेक्टर के आधार पर, अपने एक्सटेंशन की कार्रवाई को चालू किया जा सकता है. इसके लिए, होस्ट की अनुमतियां जोड़ने या कॉन्टेंट स्क्रिप्ट इंजेक्ट करने की ज़रूरत नहीं होती.

उपयोगकर्ता के एक्सटेंशन की कार्रवाई पर क्लिक करने के बाद, किसी पेज से इंटरैक्ट करने के लिए activeTab अनुमति का इस्तेमाल करें.

नियम

नियमों में शर्तें और कार्रवाइयां शामिल होती हैं. अगर कोई भी शर्त पूरी होती है, तो सभी कार्रवाइयां पूरी की जाती हैं. कार्रवाइयां setIcon() और showAction() हैं.

PageStateMatcher, वेब पेजों से सिर्फ़ तब मैच होता है, जब सूची में दी गई सभी शर्तें पूरी होती हैं. यह पेज के यूआरएल, सीएसएस कंपाउंड सिलेक्टर या किसी पेज की बुकमार्क की गई स्थिति से मेल खा सकता है. यहां दिया गया नियम, पासवर्ड फ़ील्ड मौजूद होने पर, Google पेजों पर एक्सटेंशन की कार्रवाई को चालू करता है:

let rule1 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

वीडियो वाली Google साइटों के लिए भी एक्सटेंशन की कार्रवाई चालू करने के लिए, दूसरी शर्त जोड़ी जा सकती है. ऐसा इसलिए, क्योंकि बताई गई सभी कार्रवाइयों को ट्रिगर करने के लिए, हर शर्त काफ़ी है:

let rule2 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    }),
    new chrome.declarativeContent.PageStateMatcher({
      css: ["video"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

onPageChanged इवेंट यह जांच करता है कि किसी नियम में कम से कम एक शर्त पूरी हुई है या नहीं. साथ ही, कार्रवाइयां करता है. नियम, ब्राउज़िंग सेशन के दौरान बने रहते हैं. इसलिए, एक्सटेंशन इंस्टॉल करने के दौरान, पहले removeRules का इस्तेमाल करके, पहले से इंस्टॉल किए गए नियमों को मिटाएं. इसके बाद, नए नियमों को रजिस्टर करने के लिए addRules का इस्तेमाल करें.

chrome.runtime.onInstalled.addListener(function(details) {
  chrome.declarativeContent.onPageChanged.removeRules(undefined, function() {
    chrome.declarativeContent.onPageChanged.addRules([rule2]);
  });
});

activeTab अनुमति की मदद से, आपका एक्सटेंशन अनुमति से जुड़ी कोई चेतावनी नहीं दिखाएगा. साथ ही, जब उपयोगकर्ता एक्सटेंशन ऐक्शन पर क्लिक करेगा, तो यह सिर्फ़ काम के पेजों पर चलेगा.

पेज के यूआरएल से मैच करना

यूआरएल की शर्तें पूरी होने पर, PageStateMatcher.pageurl मैच होता है. सबसे सामान्य शर्तें, होस्ट, पाथ या यूआरएल को जोड़ने के बाद, इसमें शामिल है, बराबर है, प्रीफ़िक्स या सफ़िक्स है. यहां दी गई टेबल में कुछ उदाहरण दिए गए हैं:

नियम और शर्तें	मैच
{ hostSuffix: 'google.com' }	Google के सभी यूआरएल
{ pathPrefix: '/docs/extensions' }	एक्सटेंशन के दस्तावेज़ों के यूआरएल
{ urlContains: 'developer.chrome.com' }	Chrome डेवलपर के सभी दस्तावेज़ों के यूआरएल

सभी शर्तें केस-सेंसिटिव होती हैं. शर्तों की पूरी सूची के लिए, UrlFilter देखें.

सीएसएस मैचिंग

PageStateMatcher.css शर्तें कंपाउंड सिलेक्टर होनी चाहिए. इसका मतलब है कि सिलेक्टर में व्हाइटस्पेस या ">" जैसे कम्बिनेटर शामिल नहीं किए जा सकते. इससे Chrome, सिलेक्टर को ज़्यादा असरदार तरीके से मैच कर पाता है.

कंपाउंड सिलेक्टर (ठीक है)	कॉम्प्लेक्स सिलेक्टर (ठीक नहीं है)
a	div p
iframe.special[src^='http']	p>span.highlight
ns|*	p + ol
#abcd:checked	p::first-line

सीएसएस की शर्तें सिर्फ़ दिखाए गए एलिमेंट से मैच करती हैं: अगर आपके सिलेक्टर से मैच करने वाला कोई एलिमेंट display:none है या उसका कोई पैरंट एलिमेंट display:none है, तो शर्त मैच नहीं होती. visibility:hidden से स्टाइल किए गए, स्क्रीन पर नहीं दिखने वाले या अन्य एलिमेंट से छिपे हुए एलिमेंट के लिए भी, शर्त मैच हो सकती है.

बुकमार्क की गई स्थिति से मैच करना

PageStateMatcher.isBookmarked शर्त की मदद से, उपयोगकर्ता की प्रोफ़ाइल में मौजूदा यूआरएल की, ब्राउज़र में बुकमार्क की गई स्थिति का मिलान किया जा सकता है. इस शर्त का इस्तेमाल करने के लिए, एक्सटेंशन के manifest में "बुकमार्क" की अनुमति का एलान करना ज़रूरी है.