chrome.extension

ब्यौरा

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

टाइप

ViewType

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

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

Enum

"टैब"

"पॉपअप"

प्रॉपर्टी

inIncognitoContext

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

टाइप

बूलियन

lastError

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

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

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

टाइप

ऑब्जेक्ट

प्रॉपर्टी

  • मैसेज

    स्ट्रिंग

    हुई गड़बड़ी का ब्यौरा.

तरीके

getBackgroundPage()

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

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

रिटर्न

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

getExtensionTabs()

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

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

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

पैरामीटर

  • windowId

    नंबर वैकल्पिक

रिटर्न

  • विंडो[]

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

getURL()

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

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

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

पैरामीटर

  • पाथ

    स्ट्रिंग

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

रिटर्न

  • स्ट्रिंग

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

getViews()

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

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

पैरामीटर

  • fetchProperties

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

    • tabId

      नंबर वैकल्पिक

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

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

    • टाइप

      ViewType ज़रूरी नहीं

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

    • windowId

      नंबर वैकल्पिक

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

रिटर्न

  • विंडो[]

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

isAllowedFileSchemeAccess()

प्रॉमिस 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      बूलियन

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

रिटर्न

  • Promise<boolean>

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

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

isAllowedIncognitoAccess()

प्रॉमिस 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

गुप्त-मोड में एक्सटेंशन के ऐक्सेस की स्थिति को वापस लाता है. यह उपयोगकर्ता के कंट्रोल किए गए हर एक्सटेंशन 'गुप्त मोड में अनुमति है' के मुताबिक है सेटिंग को ऐक्सेस करने की अनुमति दें.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      बूलियन

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

रिटर्न

  • Promise<boolean>

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

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

sendRequest()

प्रॉमिस ≤ 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 को गड़बड़ी के मैसेज पर सेट कर दिया जाएगा.

रिटर्न

  • वादा करें<किसी भी>

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

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

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

पैरामीटर

  • डेटा

    स्ट्रिंग

इवेंट

onRequest

&amp;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

&amp;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