chrome.extension

ब्यौरा

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

टाइप

ViewType

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

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

Enum

प्रॉपर्टी

inIncognitoContext

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

टाइप

boolean

lastError

≤ MV2 Chrome 58 के बाद से काम नहीं करता

कृपया runtime.lastError का इस्तेमाल करें.

अगर किसी ऐसीक्रोनस एक्सटेंशन एपीआई की वजह से कोई गड़बड़ी हुई है, तो कॉलबैक को लाइफ़टाइम के लिए सेट करें. अगर कोई भी गड़बड़ी नहीं हुई है, तो lastError undefined होगी.

टाइप

ऑब्जेक्ट

प्रॉपर्टी

  • ग्राहक का मैसेज

    स्ट्रिंग

    हुई गड़बड़ी की जानकारी.

तरीके

getBackgroundPage()

सिर्फ़ फ़ोरग्राउंड 
chrome.extension.getBackgroundPage()

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

रिटर्न

  • विंडो|तय नहीं है

getExtensionTabs()

≤ MV2 सिर्फ़ फ़ोरग्राउंड अब सेवा में नहीं है
chrome.extension.getExtensionTabs(
  windowId?: number,
)

कृपया extension.getViews {type: "tab"} का इस्तेमाल करें.

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

पैरामीटर

  • windowId

    नंबर ज़रूरी नहीं

रिटर्न

  • विंडो[]

    ग्लोबल विंडो ऑब्जेक्ट का कलेक्शन

getURL()

≤ MV2 Chrome 58 के बाद से काम नहीं करता
chrome.extension.getURL(
  path: string,
)

कृपया runtime.getURL का इस्तेमाल करें.

एक्सटेंशन इंस्टॉल डायरेक्ट्री में मौजूद मिलते-जुलते पाथ को पूरी तरह क्वालिफ़ाइड यूआरएल में बदलता है.

पैरामीटर

  • पाथ

    स्ट्रिंग

    किसी एक्सटेंशन में मौजूद संसाधन का पाथ, जिसे उसकी इंस्टॉल डायरेक्ट्री के संबंध में बताया गया है.

रिटर्न

  • स्ट्रिंग

    संसाधन के लिए पूरी तरह क्वालिफ़ाइड यूआरएल.

getViews()

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

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

पैरामीटर

  • fetchProperties

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

    • tabId

      नंबर ज़रूरी नहीं

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

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

    • टाइप

      ViewType ज़रूरी नहीं

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

    • windowId

      नंबर ज़रूरी नहीं

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

रिटर्न

  • विंडो[]

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

isAllowedFileSchemeAccess()

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

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

पैरामीटर

  • कॉलबैक

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

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

    (isAllowedAccess: boolean)=>void

    • isAllowedAccess

      boolean

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

रिटर्न

  • Promise<boolean>

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

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

isAllowedIncognitoAccess()

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

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

पैरामीटर

  • कॉलबैक

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

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

    (isAllowedAccess: boolean)=>void

    • isAllowedAccess

      boolean

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

रिटर्न

  • Promise<boolean>

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

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

sendRequest()

प्रॉमिस &leq; MV2 अब काम नहीं करता
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
)

कृपया runtime.sendMessage का इस्तेमाल करें.

एक्सटेंशन में, अन्य लिसनर को एक ही अनुरोध भेजता है. यह runtime.connect की तरह है, लेकिन यह वैकल्पिक जवाब के साथ सिर्फ़ एक अनुरोध भेजता है. एक्सटेंशन के हर पेज में extension.onRequest इवेंट सक्रिय होता है.

पैरामीटर

  • extensionId

    स्ट्रिंग ज़रूरी नहीं

    उस एक्सटेंशन का एक्सटेंशन आईडी जिससे कनेक्ट करना है. अगर इसे छोड़ा जाता है, तो डिफ़ॉल्ट रूप से आपका एक्सटेंशन चुना जाता है.

  • CANNOT TRANSLATE

    कोई भी

  • कॉलबैक

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

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

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

    (response: any)=>void

    • जवाब

      कोई भी

      अनुरोध के हैंडलर से भेजा गया JSON रिस्पॉन्स ऑब्जेक्ट. अगर एक्सटेंशन से कनेक्ट करते समय कोई गड़बड़ी होती है, तो कॉलबैक को बिना किसी आर्ग्युमेंट के कॉल किया जाएगा. साथ ही, runtime.lastError को गड़बड़ी के मैसेज पर सेट कर दिया जाएगा.

रिटर्न

  • वादा<any>

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

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

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

पैरामीटर

  • डेटा

    स्ट्रिंग

इवेंट

onRequest

&leq; MV2 अब सेवा में नहीं है
chrome.extension.onRequest.addListener(
  callback: function,
)

कृपया runtime.onMessage का इस्तेमाल करें.

तब सक्रिय होता है, जब कोई अनुरोध किसी एक्सटेंशन प्रोसेस या कॉन्टेंट स्क्रिप्ट से भेजा जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (request: any,sender: runtime.MessageSender,sendResponse: function)=>void

    • CANNOT TRANSLATE

      कोई भी

    • भेजने वाला

      runtime.MessageSender

    • sendResponse

      फ़ंक्शन

      sendResponse पैरामीटर ऐसा दिखता है: 

      ()=>void

onRequestExternal

&leq; MV2 अब सेवा में नहीं है
chrome.extension.onRequestExternal.addListener(
  callback: function,
)

कृपया runtime.onMessageExternal का इस्तेमाल करें.

किसी दूसरे एक्सटेंशन से अनुरोध भेजे जाने पर सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (request: any,sender: runtime.MessageSender,sendResponse: function)=>void

    • CANNOT TRANSLATE

      कोई भी

    • भेजने वाला

      runtime.MessageSender

    • sendResponse

      फ़ंक्शन

      sendResponse पैरामीटर ऐसा दिखता है: 

      ()=>void