chrome.extension

ब्यौरा

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

टाइप

ViewType

Chrome 44 और उसके बाद के वर्शन

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

Enum

"tab"

"popup"

प्रॉपर्टी

inIncognitoContext

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

टाइप

बूलियन

तरीके

getBackgroundPage()

सिर्फ़ फ़ोरग्राउंड ऐप्लिकेशन के लिए 
chrome.extension.getBackgroundPage()

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

रिटर्न

  • विंडो | undefined

getViews()

सिर्फ़ फ़ोरग्राउंड ऐप्लिकेशन के लिए 
chrome.extension.getViews(
  fetchProperties?: object,
)

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

पैरामीटर

  • fetchProperties

    ऑब्जेक्ट ज़रूरी नहीं है

    • tabId

      number ज़रूरी नहीं

      Chrome 54 और उसके बाद के वर्शन

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

    • टाइप

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

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

    • windowId

      number ज़रूरी नहीं

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

रिटर्न

  • Window[]

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

isAllowedFileSchemeAccess()

वादा करना 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      बूलियन

      अगर एक्सटेंशन 'file://' स्कीम को ऐक्सेस कर सकता है, तो True. अगर नहीं, तो False.

रिटर्न

  • Promise<boolean>

    Chrome 99 और उसके बाद के वर्शन

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

isAllowedIncognitoAccess()

वादा करना 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      बूलियन

      अगर एक्सटेंशन के पास गुप्त मोड का ऐक्सेस है, तो 'सही'. अगर नहीं है, तो 'गलत'.

रिटर्न

  • Promise<boolean>

    Chrome 99 और उसके बाद के वर्शन

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

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

पैरामीटर

  • डेटा

    स्ट्रिंग

इवेंट