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