chrome.clipboard

شرح

chrome.clipboard API ارائه شده است تا به کاربران امکان دسترسی به داده های کلیپ بورد را بدهد. این یک راه حل موقت برای برنامه های پلتفرم کرومئوس است تا زمانی که جایگزین وب باز موجود باشد. هنگامی که راه حل وب باز در دسترس باشد، منسوخ خواهد شد، که می تواند در سه ماهه چهارم سال 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,
)

داده های تصویر را به کلیپ بورد تنظیم می کند.

مولفه های

  • داده های تصویری

    ArrayBuffer

    Chrome 60+

    داده های تصویر کدگذاری شده

  • نوع

    ImageType

    نوع تصویر ارسال شده

  • موارد اضافی

    AdditionalDataItem [] اختیاری است

    Chrome 60+

    آیتم های داده اضافی برای توصیف داده های تصویر. اگر خطایی وجود داشته باشد، تماس برگشتی با chrome.runtime.lastError روی کد خطا تنظیم شده است. به مجوزهای Clipboard و ClipboardWrite نیاز دارد.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 91+

    Promises فقط برای Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، پلتفرم های دیگر نیاز به استفاده از callback دارند.

مناسبت ها

onClipboardDataChanged

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

با تغییر داده های کلیپ بورد فعال می شود. برای افزودن شنونده به رویداد chrome.clipboard.onClipboardDataChanged به مجوزهای کلیپ بورد و کلیپ بورد نیاز دارد. پس از فعال شدن این رویداد، داده های کلیپ بورد با فراخوانی document.execCommand('paste') در دسترس هستند.

مولفه های

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    ()=>void