chrome.clipboard

Nội dung mô tả

API chrome.clipboard được cung cấp để cho phép người dùng truy cập vào dữ liệu trong 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ế qua web mở. Giải pháp web mở sẽ không được dùng nữa khi có giải pháp web mở, có thể vào quý 4 năm 2017.

Quyền

clipboard

Phạm vi cung cấp

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

Loại

AdditionalDataItem

Thuộc tính

  • data

    string

    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

Liệt kê

ImageType

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

Liệt kê

"png"

"jpeg"

Phương thức

setImageData()

Cam kết Chrome 57 trở lên 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

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

Tham 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 ghi vào bảng nhớ tạm và ghi vào bảng nhớ tạm.

  • số gọi lại

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

    Tham số callback sẽ 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 bảng nhớ tạm thay đổi. Cần có quyền truy cập vào bảng nhớ tạm và bảng nhớ tạm để 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 sẽ có thể xem dữ liệu bảng nhớ tạm bằng cách gọi document.execCommand('paste').

Tham số

  • số gọi lại

    hàm

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

    ()=>void