chrome.printingMetrics

Deskripsi

Gunakan chrome.printingMetrics API untuk mengambil data tentang penggunaan pencetakan.

Izin

printingMetrics

Ketersediaan

Chrome 79+ Khusus ChromeOS Memerlukan kebijakan

Jenis

ColorMode

Enum

"BLACK_AND_WHITE"
Menentukan bahwa mode hitam putih digunakan.

"COLOR"
Menentukan bahwa mode warna digunakan.

DuplexMode

Enum

"ONE_SIDED"
Menentukan bahwa pencetakan satu sisi digunakan.

"TWO_SIDED_LONG_EDGE"
Menentukan bahwa pencetakan dua sisi digunakan, membalik pada tepi panjang.

"TWO_SIDED_SHORT_EDGE"
Menentukan bahwa pencetakan dua sisi digunakan, membalik di tepi pendek.

MediaSize

Properti

  • tinggi

    angka

    Tinggi (dalam mikrometer) media yang digunakan untuk pencetakan.

  • vendorId

    string

    ID yang disediakan vendor, misalnya "iso_a3_297x420mm" atau "na_index-3x5_3x5in". Kemungkinan nilai adalah nilai atribut IPP "media" dan dapat ditemukan di halaman IANA .

  • lebar

    angka

    Lebar (dalam mikrometer) media yang digunakan untuk mencetak.

Printer

Properti

  • nama

    string

    Nama printer yang ditampilkan.

  • source

    PrinterSource

    Sumber printer.

  • uri

    string

    Jalur lengkap untuk printer. Berisi protokol, nama host, port, dan antrean.

PrinterSource

Sumber printer.

Enum

"USER"
Menentukan bahwa printer ditambahkan oleh pengguna.

"POLICY"
Menentukan bahwa printer ditambahkan melalui kebijakan.

PrintJobInfo

Properti

  • completionTime

    angka

    Waktu penyelesaian tugas (dalam milidetik setelah epoch Unix).

  • creationTime

    angka

    Waktu pembuatan tugas (dalam milidetik setelah epoch Unix).

  • id

    string

    ID tugas.

  • numberOfPages

    angka

    Jumlah halaman dalam dokumen.

  • printer

    Printer

    Info tentang printer yang mencetak dokumen.

  • printer_status

    PrinterStatus

    Chrome 85+

    Status printer.

  • setelan

    PrintSettings

    Setelan tugas cetak.

  • Sumber yang menunjukkan siapa yang memulai tugas cetak.

  • sourceId

    string opsional

    ID sumber. Null jika sumbernya adalah PRINT_PREVIEW atau ANDROID_APP.

  • Status akhir tugas.

  • judul

    string

    Judul dokumen yang dicetak.

PrintJobSource

Sumber tugas cetak.

Enum

"PRINT_PREVIEW"
Menentukan bahwa tugas dibuat dari halaman Pratinjau Cetak yang dimulai oleh pengguna.

"ANDROID_APP"
Menentukan bahwa tugas dibuat dari Aplikasi Android.

"EXTENSION"
Menentukan bahwa tugas dibuat oleh ekstensi melalui Chrome API.

"ISOLATED_WEB_APP"
Menentukan bahwa tugas dibuat oleh Aplikasi Web Terisolasi melalui API.

PrintJobStatus

Menentukan status akhir tugas cetak.

Enum

"FAILED"
Menentukan bahwa tugas cetak terganggu karena beberapa error.

"DIBATALKAN"
Menentukan bahwa tugas cetak dibatalkan oleh pengguna atau melalui API.

"DICETAK"
Menentukan bahwa tugas cetak dicetak tanpa error.

PrintSettings

Properti

  • warna

    ColorMode

    Mode warna yang diminta.

  • salinan

    angka

    Jumlah salinan yang diminta.

  • duplex

    DuplexMode

    Mode dupleks yang diminta.

  • mediaSize

    MediaSize

    Ukuran media yang diminta.

Metode

getPrintJobs()

Janji 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

Menampilkan daftar tugas cetak yang telah selesai.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti: 

    (jobs: PrintJobInfo[]) => void

Hasil

  • Promise<PrintJobInfo[]>

    Chrome 96+

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

Acara

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

Peristiwa yang dipicu saat tugas cetak selesai. Hal ini mencakup status penghentian apa pun: FAILED, CANCELED, dan PRINTED.

Parameter