chrome.clipboard

الوصف

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

الأذونات

clipboard

مدى التوفّر

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

الأنواع

AdditionalDataItem

أماكن إقامة

  • البيانات

    سلسلة

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

  • كتابة

    DataItemType

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

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

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

Enum

"png"

"jpeg"

الطُرق

setImageData()

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

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

المعلمات

  • بيانات الصورة

    مخزن المصفوفات

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

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

  • كتابة

    ImageType

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

  • additionalItems

    AdditionalDataItem[] اختياري

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

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

  • رد الاتصال

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

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

    () => void

المرتجعات

  • وعود <باطلة>

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

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

فعاليات

onClipboardDataChanged

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

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

المعلمات

  • رد الاتصال

    دالة

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

    () => void