chrome.clipboard

תיאור

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

הרשאות

clipboard

זמינות

ערוץ Dev ChromeOS בלבד

סוגים

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 ואילך

    פריטי נתונים נוספים לתיאור נתוני תמונה. אם יש שגיאה, הקריאה החוזרת (callback) נקראת עם chrome.runtime.lastError שמוגדר לקוד השגיאה. נדרשות הרשאות ללוח ול-clipboardWrite.

  • callback

    function optional

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

    () => void

החזרות

  • Promise<void>

    ‫Chrome מגרסה 91 ואילך

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

אירועים

onClipboardDataChanged

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

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

פרמטרים

  • callback

    פונקציה

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

    () => void