chrome.clipboard

תיאור

ממשק ה-API של chrome.clipboard מסופק כדי לאפשר למשתמשים לגשת לנתונים של לוח העריכה. זהו פתרון זמני לאפליקציות פלטפורמה של ChromeOS עד שיהיה זמין פתרון חלופי לאינטרנט הפתוח. התכונה תוצא משימוש ברגע שיהיה פתרון לאינטרנט הפתוח, שיכול להיות ברבעון הרביעי של 2017.

הרשאות

clipboard

זמינות

Dev channel ChromeOS only

סוגים

AdditionalDataItem

מאפיינים

  • נתונים

    מחרוזת

    התוכן של פריט הנתונים הנוסף. מחרוזת טקסט פשוט אם type היא textPlain, או מחרוזת תגי עיצוב אם type היא textHtml. הגודל המקסימלי של הנתונים הוא 2MB.

  • סוג

    DataItemType

    סוג פריט הנתונים הנוסף.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

סוגי תמונות נתמכים.

Enum

‪"png"

‪"jpeg"

Methods

setImageData()

Promise Chrome 57 ואילך 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

הגדרת נתוני תמונה בלוח.

פרמטרים

  • imageData

    ArrayBuffer

    ‫Chrome 60 ואילך

    נתוני התמונה המקודדים.

  • סוג

    ImageType

    סוג התמונה שמועברת.

  • additionalItems

    ‫AdditionalDataItem[] אופציונלי

    ‫Chrome 60 ואילך

    פריטי נתונים נוספים לתיאור נתוני תמונה. הקריאה החוזרת מתבצעת עם chrome.runtime.lastError שמוגדר כקוד שגיאה אם יש שגיאה. נדרשות הרשאות ללוח ולהעתקה ללוח.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome 91 ואילך

    ההבטחות נתמכות רק ב-Manifest V3 ובגרסאות מאוחרות יותר. בפלטפורמות אחרות צריך להשתמש בפונקציות Callback.

אירועים

onClipboardDataChanged

‫Chrome 56 ואילך 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

האירוע מופעל כשנתוני הלוח משתנים. נדרשות הרשאות ללוח ולהרשאות clipboardRead כדי להוסיף listener לאירוע chrome.clipboard.onClipboardDataChanged. אחרי שהאירוע הזה מופעל, הנתונים בלוח ההעתקה זמינים באמצעות קריאה לפונקציה document.execCommand('paste').

פרמטרים

  • callback

    פונקציה

    הפרמטר callback נראה כך: 

    () => void