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[] optional

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

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • Promise<void>

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

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

इवेंट

onClipboardDataChanged

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void