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,
)

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

पैरामीटर

  • इमेज डेटा

    अरेबफ़र

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

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

  • टाइप

    ImageType

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

  • additionalItems

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

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

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

  • कॉलबैक

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

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

    () => void

रिटर्न

  • प्रॉमिस<void>

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

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

इवेंट

onClipboardDataChanged

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    () => void