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ở. API này sẽ không được dùng nữa 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 tuý 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 đã mã hoá.

  • loại

    ImageType

    Loại hình ảnh đang đượ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 với chrome.runtime.lastError được đặt thành mã lỗi nếu có lỗi. Cần có quyền truy cập vào bảng nhớ tạm và quyền ghi vào bảng nhớ tạm.

  • 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

    Các promise 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 truy cập vào bảng nhớ tạm và quyền 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, dữ liệu trên bảng nhớ tạm sẽ có sẵn bằng cách gọi document.execCommand('paste').

Thông số

  • callback

    hàm

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

    () => void