browser.extension

ब्यौरा

chrome.extension एपीआई में ऐसी सुविधाएं हैं जिनका इस्तेमाल किसी भी एक्सटेंशन पेज पर किया जा सकता है. इसमें किसी एक्सटेंशन और उसकी कॉन्टेंट स्क्रिप्ट के बीच या एक्सटेंशन के बीच मैसेज भेजने की सुविधा शामिल है. इसके बारे में मैसेज पासिंग में विस्तार से बताया गया है.

टाइप

ViewType

Chrome 44+ browser.* Chrome 148 के बाद से

एक्सटेंशन व्यू का टाइप.

Enum

"tab"

"popup"

प्रॉपर्टी

inIncognitoContext

यह गुप्त टैब में चल रही कॉन्टेंट स्क्रिप्ट और गुप्त प्रोसेस में चल रहे एक्सटेंशन पेजों के लिए सही है. यह सिर्फ़ उन एक्सटेंशन पर लागू होता है जिनमें 'split' incognito_behavior है.

टाइप

बूलियन

तरीके

getBackgroundPage()

सिर्फ़ फ़ोरग्राउंड 
browser.extension.getBackgroundPage(): Window | undefined

मौजूदा एक्सटेंशन में चल रहे बैकग्राउंड पेज के लिए, JavaScript 'window' ऑब्जेक्ट दिखाता है. अगर एक्सटेंशन में कोई बैकग्राउंड पेज नहीं है, तो शून्य दिखाता है.

रिटर्न

  • विंडो | undefined

getViews()

सिर्फ़ फ़ोरग्राउंड 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

यह मौजूदा एक्सटेंशन में चल रहे हर पेज के लिए, JavaScript 'window' ऑब्जेक्ट का कलेक्शन दिखाता है.

पैरामीटर

  • fetchProperties

    object ज़रूरी नहीं

    • tabId

      number ज़रूरी नहीं

      Chrome 54+ browser.* Chrome 148 से

      टैब आईडी के हिसाब से व्यू ढूंढना. अगर इस फ़ील्ड को शामिल नहीं किया जाता है, तो सभी व्यू दिखाए जाते हैं.

    • टाइप

      ViewType ज़रूरी नहीं है

      किस तरह का व्यू पाना है. अगर इसे शामिल नहीं किया जाता है, तो सभी व्यू दिखते हैं. इनमें बैकग्राउंड पेज और टैब भी शामिल हैं.

    • windowId

      number ज़रूरी नहीं

      वह विंडो जिसमें खोज को सीमित करना है. अगर इसे शामिल नहीं किया जाता है, तो सभी व्यू दिखते हैं.

रिटर्न

  • Window[]

    ग्लोबल ऑब्जेक्ट का कलेक्शन

isAllowedFileSchemeAccess()

browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>

'file://' स्कीम के लिए, एक्सटेंशन के ऐक्सेस की स्थिति को वापस लाता है. यह सेटिंग, हर एक्सटेंशन के लिए 'फ़ाइल के यूआरएल को ऐक्सेस करने की अनुमति दें' सेटिंग से मेल खाती है. इसे उपयोगकर्ता कंट्रोल करता है. इसे chrome://extensions पेज से ऐक्सेस किया जा सकता है.

रिटर्न

  • Promise<boolean>

    Chrome 99+ browser.* Chrome 148 से

isAllowedIncognitoAccess()

browser.extension.isAllowedIncognitoAccess(): Promise<boolean>

इससे गुप्त मोड में एक्सटेंशन के ऐक्सेस की स्थिति का पता चलता है. यह सेटिंग, हर एक्सटेंशन के लिए उपयोगकर्ता के कंट्रोल वाली 'गुप्त मोड में इस्तेमाल करने की अनुमति है' सेटिंग के मुताबिक होती है. इसे chrome://extensions पेज से ऐक्सेस किया जा सकता है.

रिटर्न

  • Promise<boolean>

    Chrome 99+ browser.* Chrome 148 से

setUpdateUrlData()

browser.extension.setUpdateUrlData(
  data: string,
): void

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

पैरामीटर

  • डेटा

    स्ट्रिंग