chrome.clipboard

الوصف

يتم توفير واجهة برمجة التطبيقات chrome.clipboard للسماح للمستخدمين بالوصول إلى بيانات الحافظة. هذا حلّ مؤقت لتطبيقات منصة ChromeOS إلى أن يتوفّر بديل على الويب المفتوح. سيتم إيقافها نهائيًا عند توفّر حلّ على الويب المفتوح، وقد يكون ذلك في الربع الرابع من عام 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,
): Promise<void>

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

المعلمات

  • imageData

    ArrayBuffer

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

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

  • النوع

    ImageType

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

  • additionalItems

    AdditionalDataItem[] اختيارية

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

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

  • callback

    الدالة اختيارية

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

    () => void

المرتجعات

  • Promise<void>

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

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

الفعاليات

onClipboardDataChanged

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

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

المعلمات

  • callback

    دالة

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

    () => void