chrome.clipboard

الوصف

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

الأذونات

clipboard

مدى توفّر الخدمة

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

الأنواع

AdditionalDataItem

أماكن إقامة

  • البيانات

    سلسلة

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

  • كتابة

    DataItemType

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

DataItemType

التعداد

"textPlain"

"textHtml"

ImageType

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

التعداد

"png"

"jpeg"

الطُرق

setImageData()

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

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

المَعلمات

  • imageData

    ArrayBuffer

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

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

  • كتابة

    ImageType

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

  • additionalItems

    AdditionalDataItem[] اختيارية

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

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

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

فعاليات

onClipboardDataChanged

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    ()=>void