chrome.clipboard

ब्यौरा

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

अनुमतियां

clipboard

उपलब्धता

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

टाइप

AdditionalDataItem

प्रॉपर्टी

  • डेटा

    स्ट्रिंग

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

  • टाइप

    DataItemType

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

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

साथ काम करने वाले इमेज टाइप.

Enum

"png"

"jpeg"

तरीके

setImageData()

प्रॉमिस Chrome 57+ 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

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

पैरामीटर

  • imageData

    ArrayBuffer

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

    कोड में बदला गया इमेज का डेटा.

  • टाइप

    ImageType

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

  • additionalItems

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

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

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

  • कॉलबैक

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

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

    ()=>void

रिटर्न

  • Promise<void>

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

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

इवेंट

onClipboardDataChanged

Chrome 56 और इसके बाद के वर्शन 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    ()=>void