chrome.clipboard

Deskripsi

API chrome.clipboard disediakan untuk memungkinkan pengguna mengakses data papan klip. Ini adalah solusi sementara untuk aplikasi platform ChromeOS hingga alternatif web terbuka tersedia. API ini akan dihentikan setelah solusi web terbuka tersedia, yang mungkin terjadi pada Kuartal 4 2017.

Izin

clipboard

Ketersediaan

Saluran Dev Khusus ChromeOS

Jenis

AdditionalDataItem

Properti

  • data

    string

    Konten item data tambahan. String teks biasa jika type adalah "textPlain" atau string markup jika type adalah "textHtml". Ukuran data tidak boleh melebihi 2 MB.

  • jenis

    DataItemType

    Jenis item data tambahan.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Jenis gambar yang didukung.

Enum

"png"

"jpeg"

Metode

setImageData()

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

Menetapkan data gambar ke papan klip.

Parameter

  • imageData

    ArrayBuffer

    Chrome 60+

    Data gambar yang dienkode.

  • jenis

    ImageType

    Jenis gambar yang diteruskan.

  • additionalItems

    AdditionalDataItem[] opsional

    Chrome 60+

    Item data tambahan untuk mendeskripsikan data gambar. Callback dipanggil dengan chrome.runtime.lastError disetel ke kode error jika terjadi error. Memerlukan izin clipboard dan clipboardWrite.

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    () => void

Hasil

  • Promise<void>

    Chrome 91+

    Promise hanya didukung untuk Manifest V3 dan yang lebih baru, platform lain harus menggunakan callback.

Acara

onClipboardDataChanged

Chrome 56+ 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Diaktifkan saat data papan klip berubah. Memerlukan izin clipboard dan clipboardRead untuk menambahkan pemroses ke peristiwa chrome.clipboard.onClipboardDataChanged. Setelah peristiwa ini dipicu, data papan klip tersedia dengan memanggil document.execCommand('paste').

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    () => void