chrome.clipboard

ब्यौरा

chrome.clipboard एपीआई की मदद से, उपयोगकर्ता क्लिपबोर्ड का डेटा ऐक्सेस कर सकते हैं. यह ChromeOS प्लैटफ़ॉर्म ऐप्लिकेशन के लिए एक अस्थायी समाधान है. यह तब तक उपलब्ध रहेगा, जब तक ओपन-वेब का विकल्प उपलब्ध नहीं हो जाता. ओपन-वेब समाधान उपलब्ध होने के बाद, इसे बंद कर दिया जाएगा. ऐसा 2017 की चौथी तिमाही में हो सकता है.

अनुमतियां

clipboard

उपलब्धता

डेव चैनल सिर्फ़ ChromeOS के लिए

टाइप

AdditionalDataItem

प्रॉपर्टी

  • डेटा

    स्ट्रिंग

    अतिरिक्त डेटा आइटम का कॉन्टेंट. अगर type "textPlain" है, तो सादे टेक्स्ट की स्ट्रिंग या अगर type "textHtml" है, तो मार्कअप स्ट्रिंग. डेटा का साइज़ 2 एमबी से ज़्यादा नहीं होना चाहिए.

  • टाइप

    DataItemType

    अतिरिक्त डेटा आइटम का टाइप.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

इमेज के ऐसे टाइप जो इस्तेमाल किए जा सकते हैं.

Enum

"png"

"jpeg"

तरीके

setImageData()

Promise Chrome 57 और इसके बाद के वर्शन 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

इससे इमेज का डेटा, क्लिपबोर्ड पर सेट होता है.

पैरामीटर

  • imageData

    ArrayBuffer

    Chrome 60+

    एन्कोड किया गया इमेज डेटा.

  • टाइप

    ImageType

    पास की जा रही इमेज का टाइप.

  • additionalItems

    AdditionalDataItem[] ज़रूरी नहीं

    Chrome 60+

    इमेज के डेटा के बारे में बताने के लिए, डेटा के अन्य आइटम. अगर कोई गड़बड़ी होती है, तो कॉलबैक को chrome.runtime.lastError के साथ कॉल किया जाता है. इसे गड़बड़ी के कोड पर सेट किया जाता है. इसके लिए, क्लिपबोर्ड और clipboardWrite की अनुमतियां ज़रूरी हैं.

  • कॉलबैक

    function ज़रूरी नहीं

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

    () => void

रिटर्न

  • वादा<शून्य>

    Chrome 91+

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

इवेंट

onClipboardDataChanged

Chrome 56+ 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

क्लिपबोर्ड का डेटा बदलने पर ट्रिगर होता है. chrome.clipboard.onClipboardDataChanged इवेंट में लिसनर जोड़ने के लिए, क्लिपबोर्ड और clipboardRead की अनुमतियां ज़रूरी हैं. इस इवेंट के ट्रिगर होने के बाद, document.execCommand('paste') को कॉल करके क्लिपबोर्ड का डेटा उपलब्ध हो जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void