chrome.clipboard

Mô tả

API chrome.clipboard được cung cấp để cho phép người dùng truy cập vào dữ liệu của bảng nhớ tạm. Đây là giải pháp tạm thời cho các ứng dụng nền tảng ChromeOS cho đến khi có giải pháp thay thế trên web mở. Giải pháp này sẽ không được dùng nữa sau khi có giải pháp web mở, có thể là vào quý 4 năm 2017.

Quyền

clipboard

Phạm vi cung cấp

Kênh nhà phát triển Chỉ dành cho ChromeOS

Loại

AdditionalDataItem

Thuộc tính

  • khác

    chuỗi

    Nội dung của mục dữ liệu bổ sung. Chuỗi văn bản thuần túy nếu type là "textPlain" hoặc chuỗi đánh dấu nếu type là "textHtml". Dữ liệu không được vượt quá 2 MB.

  • loại

    DataItemType

    Loại mục dữ liệu bổ sung.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Các loại hình ảnh được hỗ trợ.

Enum

"png"

"jpeg"

Phương thức

setImageData()

Promise Chrome 57 trở lên 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

Đặt dữ liệu hình ảnh vào bảng nhớ tạm.

Thông số

  • imageData

    ArrayBuffer

    Chrome 60 trở lên

    Dữ liệu hình ảnh được mã hoá.

  • loại

    ImageType

    Loại hình ảnh được truyền.

  • additionalItems

    AdditionalDataItem[] không bắt buộc

    Chrome 60 trở lên

    Các mục dữ liệu bổ sung để mô tả dữ liệu hình ảnh. Lệnh gọi lại được gọi bằng chrome.runtime.lastError được đặt thành mã lỗi nếu có lỗi. Yêu cầu quyền clipboard và clipboardWrite.

  • callback

    hàm không bắt buộc

    Tham số callback có dạng như sau: 

    () => void

Giá trị trả về

  • Promise<void>

    Chrome 91 trở lên

    Lời hứa chỉ được hỗ trợ cho Manifest V3 trở lên, các nền tảng khác cần sử dụng lệnh gọi lại.

Sự kiện

onClipboardDataChanged

Chrome 56 trở lên 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Được kích hoạt khi dữ liệu trong bảng nhớ tạm thay đổi. Cần có quyền clipboard và clipboardRead để thêm trình nghe vào sự kiện chrome.clipboard.onClipboardDataChanged. Sau khi sự kiện này kích hoạt, bạn có thể truy cập vào dữ liệu trong bảng nhớ tạm bằng cách gọi document.execCommand('paste').

Thông số

  • callback

    hàm

    Tham số callback có dạng như sau: 

    () => void