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ế web mở. Tính năng này 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

  • dữ liệu

    string

    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á 2MB.

  • loại

    DataItemType

    Loại của 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()

Lời hứa 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ố

  • dữ liệu hình ảnh

    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 dữ liệu vào bảng nhớ tạm và 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ề

  • Lời hứa<vô hiệu>

    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 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, dữ liệu trong bảng nhớ tạm sẽ có sẵn 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