chrome.clipboard

شرح

chrome.clipboard API برای این ارائه شده است که به کاربران اجازه دهد به داده‌های بریده‌دان دسترسی داشته باشند. این راه‌حلی موقت برای برنامه‌های پلاتفرم chromeos است تا زمانی که جایگزین وب آزاد دردسترس قرار گیرد. وقتی راهکار وب باز دردسترس قرار گیرد، این ویژگی منسوخ خواهد شد که ممکن است در سه‌ماهه چهارم ۲۰۱۷ باشد.

اجازه‌ها

clipboard

دردسترس بودن

کانال برنامه‌نویس‌ها فقط ChromeOS

انواع

AdditionalDataItem

مشخصات

  • داده

    رشته

    محتوای مورد داده‌های اضافی. رشته نوشتار ساده اگر type «textPlain» باشد یا رشته نشانه‌گذاری اگر type «textHtml» باشد. داده‌ها نباید از ۲ مگابایت بیشتر باشد.

  • نوع

    DataItemType

    نوع مورد داده‌های اضافی.

DataItemType

شمارشی

"textPlain"

"textHtml"

ImageType

انواع تصویر پشتیبانی‌شده.

شمارشی

"png"

"jpeg"

روش‌ها

setImageData()

Promise Chrome نسخه ۵۷ و بالاتر 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

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

پارامترها

  • imageData

    ArrayBuffer

    Chrome نسخه ۶۰ و بالاتر

    داده‌های تصویر کدبندی‌شده.

  • نوع

    ImageType

    نوع تصویری که ارسال می‌شود.

  • additionalItems

    AdditionalDataItem[] اختیاری

    Chrome نسخه ۶۰ و بالاتر

    موارد داده‌های دیگر برای توصیف داده‌های تصویر. درصورت وجود خطا، فراخوانی برگشتی با chrome.runtime.lastError تنظیم‌شده روی کد خطا فراخوانی می‌شود. به اجازه‌های clipboard و clipboardWrite نیاز دارد.

  • تماس برگشتی

    تابع اختیاری

    پارامتر callback به‌صورت زیر است: 

    () => void

بازگشتی‌ها

  • Promise<void>

    Chrome نسخه ۹۱ به بالا

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

رویدادها

onClipboardDataChanged

Chrome نسخه ۵۶ به بالا 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    () => void