chrome.printingMetrics

Deskripsi

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

Izin

printingMetrics

Ketersediaan

Chrome 79 dan yang lebih baru Khusus ChromeOS Mewajibkan kebijakan

Jenis

ColorMode

Enum

"BLACK_AND_WHITE"
Menentukan bahwa mode hitam putih digunakan.

"Color"
Menentukan bahwa mode warna yang digunakan.

DuplexMode

Enum

"ONE_SIDED"
Menentukan bahwa pencetakan satu sisi digunakan.

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

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

MediaSize

Properti

  • tinggi

    angka

    Tinggi (dalam mikrometer) media yang digunakan untuk mencetak.

  • vendorId

    string

    ID yang disediakan vendor, mis. "iso_a3_297x420mm" atau "na_index-3x5_3x5in". Nilai yang mungkin adalah nilai "media" IPP dan dapat ditemukan di halaman IANA .

  • lebar

    angka

    Lebar (dalam mikrometer) media yang digunakan untuk pencetakan.

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 dan yang lebih baru

    Status printer.

  • setelan

    PrintSettings

    Setelan tugas pencetakan.

  • Sumber yang menunjukkan siapa yang memulai tugas pencetakan.

  • sourceId

    string opsional

    ID sumber. Null jika sumbernya adalah PRINT_PRATINJAU atau ANDROID_APP.

  • Status akhir pekerjaan.

  • judul

    string

    Judul dokumen yang dicetak.

PrintJobSource

Sumber tugas pencetakan.

Enum

"PRINT_PRATINJAU"
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 pencetakan.

Enum

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

"CANCELED"
Menentukan bahwa tugas pencetakan dibatalkan oleh pengguna atau melalui API.

"PRINTED"
Menentukan bahwa tugas pencetakan 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,
)

Menampilkan daftar tugas pencetakan yang telah selesai.

Parameter

  • callback

    fungsi opsional

    Parameter callback terlihat seperti ini: 

    (jobs: PrintJobInfo[]) => void

Hasil

  • Promise<PrintJobInfo[]>

    Chrome 96 dan yang lebih baru

    Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onPrintJobFinished

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

Peristiwa diaktifkan saat tugas pencetakan selesai. Hal ini termasuk semua status penghentian: GAGAL, DIBATALKAN, dan DICETAK.

Parameter