ब्यौरा
chrome.clipboard
एपीआई इसलिए उपलब्ध कराया गया है, ताकि उपयोगकर्ता क्लिपबोर्ड का डेटा ऐक्सेस कर सकें. यह ChromeOS प्लैटफ़ॉर्म ऐप्लिकेशन के लिए, कुछ समय के लिए उपलब्ध समाधान है. इसे तब तक इस्तेमाल किया जाता है, जब तक ओपन-वेब का विकल्प उपलब्ध न हो. ओपन वेब सलूशन उपलब्ध होने पर इसे बंद कर दिया जाएगा. ऐसा 2017 की चौथी तिमाही में हो सकता है.
अनुमतियां
clipboard
उपलब्धता
टाइप
AdditionalDataItem
प्रॉपर्टी
-
डेटा
स्ट्रिंग
अतिरिक्त डेटा आइटम का कॉन्टेंट. अगर
type
"textPlain" है, तो सादे टेक्स्ट वाली स्ट्रिंग डालें. अगरtype
"textHtml" है, तो मार्कअप स्ट्रिंग. डेटा का साइज़ 2 एमबी से ज़्यादा नहीं होना चाहिए. -
टाइप
अतिरिक्त डेटा आइटम का टाइप.
DataItemType
Enum
"textPlain"
"textHtml"
ImageType
साथ काम करने वाले इमेज टाइप.
Enum
"png"
"jpeg"
तरीके
setImageData()
chrome.clipboard.setImageData(
imageData: ArrayBuffer,
type: ImageType,
additionalItems?: AdditionalDataItem[],
callback?: function,
)
इमेज डेटा को क्लिपबोर्ड पर सेट करता है.
पैरामीटर
-
imageData
ArrayBuffer
Chrome 60 के बाद के वर्शनकोड में बदला गया इमेज का डेटा.
-
टाइप
पास की जा रही इमेज का टाइप.
-
additionalItems
AdditionalDataItem[] ज़रूरी नहीं है
Chrome 60 के बाद के वर्शनइमेज से जुड़े डेटा के बारे में बताने के लिए अतिरिक्त डेटा आइटम. अगर कोई गड़बड़ी होती है, तो कॉलबैक को कॉल किया जाता है, जिसमें
chrome.runtime.lastError
को गड़बड़ी कोड पर सेट किया जाता है. क्लिपबोर्ड और क्लिपबोर्डराइट की अनुमतियों की ज़रूरत है. -
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
Promise<void>
Chrome 91 और इसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
इवेंट
onClipboardDataChanged
chrome.clipboard.onClipboardDataChanged.addListener(
callback: function,
)
क्लिपबोर्ड के डेटा में बदलाव होने पर सक्रिय होता है. chrome.clipboard.onClipboardDataChanged इवेंट में लिसनर जोड़ने के लिए, क्लिपबोर्ड और क्लिपबोर्ड पढ़ने की अनुमतियां ज़रूरी है. इस इवेंट के ट्रिगर होने के बाद, document.execCommand('paste' पर कॉल करके) क्लिपबोर्ड डेटा उपलब्ध होगा.
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:() => void