chrome.clipboard

Deskripsi

chrome.clipboard API disediakan untuk memungkinkan pengguna mengakses data papan klip. Ini adalah solusi sementara untuk aplikasi platform ChromeOS hingga alternatif web terbuka tersedia. Solusi ini tidak akan digunakan lagi setelah solusi web terbuka tersedia, yang mungkin akan terjadi pada kuartal 4 tahun 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". 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 yang ditetapkan 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 Manifes 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 papan klip dan clipboardRead untuk menambahkan pemroses ke peristiwa chrome.clipboard.onClipboardDataChanged. Setelah peristiwa ini diaktifkan, data papan klip akan tersedia dengan memanggil document.execCommand('paste').

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    () => void