chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Deskripsi

API chrome.printerProvider mengekspos peristiwa yang digunakan oleh pengelola cetak untuk membuat kueri printer yang dikontrol oleh ekstensi, untuk membuat kueri kemampuannya, dan untuk mengirimkan tugas cetak ke printer ini.

Izin

printerProvider

Ketersediaan

Chrome 44+

Jenis

PrinterInfo

Properti

  • deskripsi

    string opsional

    Deskripsi printer yang dapat dibaca manusia.

  • id

    string

    ID printer unik.

  • nama

    string

    Nama printer yang dapat dibaca manusia.

PrintError

Kode error yang ditampilkan sebagai respons terhadap peristiwa onPrintRequested.

Enum

"OK"
Menentukan bahwa operasi telah berhasil diselesaikan.

"GAGAL"
Menentukan bahwa terjadi kegagalan umum.

"INVALID_TICKET"
Menentukan bahwa tiket cetak tidak valid. Misalnya, tiket tidak konsisten dengan beberapa kemampuan, atau ekstensi tidak dapat menangani semua setelan dari tiket.

"INVALID_DATA"
Menentukan bahwa dokumen tidak valid. Misalnya, data mungkin rusak atau formatnya tidak kompatibel dengan ekstensi.

PrintJob

Properti

  • contentType

    string

    Jenis konten dokumen. Format yang didukung adalah "application/pdf" dan "image/pwg-raster".

  • dokumen

    Blob

    Blob yang berisi data dokumen yang akan dicetak. Format harus cocok dengan contentType.

  • printerId

    string

    ID printer yang harus menangani tugas.

  • tiket

    objek

    Mencetak tiket dalam format CJT.

    Referensi CJT ditandai sebagai tidak digunakan lagi. Fitur ini hanya dihentikan untuk Google Cloud Print. Fitur ini tidak dihentikan untuk pencetakan ChromeOS.

  • judul

    string

    Judul tugas pencetakan.

Acara

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

Peristiwa diaktifkan saat pengelola cetak meminta kemampuan printer.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (printerId: string, resultCallback: function) => void

    • printerId

      string

    • resultCallback

      fungsi

      Parameter resultCallback terlihat seperti: 

      (capabilities: object) => void

      • capabilities

        objek

        Kemampuan perangkat dalam format CDD.

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

Peristiwa diaktifkan saat pengelola cetak meminta printer yang disediakan oleh ekstensi.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (resultCallback: function) => void

    • resultCallback

      fungsi

      Parameter resultCallback terlihat seperti: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45+ 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Peristiwa dipicu saat pengelola cetak meminta informasi tentang perangkat USB yang mungkin merupakan printer.

Catatan: Aplikasi tidak boleh mengandalkan peristiwa ini yang diaktifkan lebih dari sekali per perangkat. Jika perangkat yang terhubung didukung, perangkat tersebut akan ditampilkan dalam peristiwa onGetPrintersRequested.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (device: usb.Device, resultCallback: function) => void

    • perangkat

      usb.Device

    • resultCallback

      fungsi

      Parameter resultCallback terlihat seperti: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

Peristiwa diaktifkan saat pengelola cetak meminta pencetakan.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (printJob: PrintJob, resultCallback: function) => void