chrome.clipboard

الوصف

يتم توفير واجهة برمجة التطبيقات chrome.clipboard للسماح للمستخدمين بالوصول إلى بيانات الحافظة. هذا حلّ مؤقت لتطبيقات نظام التشغيل ChromeOS إلى أن يتوفّر بديل مفتوح المصدر على الويب. وسيتم إيقافها نهائيًا بعد توفّر حلّ الويب المفتوح، والذي قد يكون في الربع الرابع من عام 2017.

الأذونات

clipboard

مدى التوفّر

قناة مطوّري البرامج نظام التشغيل Chrome فقط

الأنواع

AdditionalDataItem

الخصائص

  • البيانات

    سلسلة

    محتوى عنصر البيانات الإضافي إما سلسلة النص العادي إذا كانت قيمة type هي "textPlain" أو سلسلة الترميز إذا كانت قيمة type هي "textHtml". يجب ألا يتجاوز حجم البيانات 2 ميغابايت.

  • النوع

    DataItemType

    نوع عنصر البيانات الإضافي

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

أنواع الصور المتوافقة

Enum

"png"

"jpeg"

الطُرق

setImageData()

Promise الإصدار 57 من Chrome والإصدارات الأحدث 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

يتم ضبط بيانات الصورة في الحافظة.

المعلمات

  • imageData

    ArrayBuffer

    الإصدار 60 من Chrome أو الإصدارات الأحدث

    بيانات الصورة المشفّرة

  • النوع

    ImageType

    نوع الصورة التي يتم تمريرها

  • additionalItems

    ‫AdditionalDataItem[] اختيارية

    الإصدار 60 من Chrome أو الإصدارات الأحدث

    عناصر بيانات إضافية لوصف بيانات الصورة يتم استدعاء دالة الاستدعاء مع ضبط chrome.runtime.lastError على رمز الخطأ في حال حدوث خطأ. يتطلّب ذلك الحصول على إذنَي clipboard وclipboardWrite.

  • callback

    function اختياري

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • وعد<فراغ>

    الإصدار 91 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

الفعاليات

onClipboardDataChanged

الإصدار 56 من Chrome والإصدارات الأحدث 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

يتم تنشيطه عند تغيير بيانات الحافظة. يتطلب ذلك الحصول على إذنَي clipboard وclipboardRead لإضافة أداة معالجة إلى حدث chrome.clipboard.onClipboardDataChanged. بعد تنشيط هذا الحدث، تصبح بيانات الحافظة متاحة من خلال استدعاء document.execCommand('paste').

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    () => void