chrome.printingMetrics

Mô tả

Sử dụng API chrome.printingMetrics để tìm nạp dữ liệu về mức sử dụng tính năng in.

Quyền

printingMetrics

Phạm vi cung cấp

Chrome 79 trở lên Chỉ ChromeOS Yêu cầu chính sách

Loại

ColorMode

Enum

"BLACK_AND_WHITE"
Chỉ định rằng bạn đã sử dụng chế độ đen trắng.

"COLOR"
Chỉ định chế độ màu đã được sử dụng.

DuplexMode

Enum

"ONE_SIDED"
Chỉ định rằng bạn đã sử dụng tính năng in một mặt.

"TWO_SIDED_LONG_EDGE"
Chỉ định rằng bạn đã sử dụng thao tác in hai mặt, lật trên cạnh dài.

"TWO_SIDED_SHORT_EDGE"
Chỉ định rằng bạn đã sử dụng thao tác in hai mặt, lật trên cạnh ngắn.

MediaSize

Thuộc tính

  • độ cao

    số

    Chiều cao (tính bằng micromet) của phương tiện dùng để in.

  • vendorId

    string

    Mã do nhà cung cấp cung cấp, ví dụ: "iso_a3_297x420mm" hoặc "na_index-3x5_3x5in". Các giá trị có thể là giá trị của "media" Thuộc tính IPP của bạn. Bạn có thể tìm thấy thuộc tính này trên trang IANA.

  • chiều rộng

    số

    Chiều rộng (tính bằng micromet) của phương tiện dùng để in.

Printer

Thuộc tính

  • tên

    string

    Tên hiển thị của máy in.

  • nguồn

    PrinterSource

    Nguồn của máy in.

  • uri

    string

    Đường dẫn đầy đủ cho máy in. Chứa giao thức, tên máy chủ, cổng và hàng đợi.

PrinterSource

Nguồn của máy in.

Enum

"USER"
Chỉ định rằng máy in đã được người dùng thêm.

"POLICY"
Chỉ định rằng máy in đã được thêm thông qua chính sách.

PrintJobInfo

Thuộc tính

  • completionTime

    số

    Thời gian hoàn thành công việc (tính bằng mili giây trong thời gian bắt đầu của hệ thống Unix).

  • creationTime

    số

    Thời gian tạo công việc (tính bằng mili giây trong thời gian bắt đầu của hệ thống Unix).

  • id

    string

    Mã của công việc.

  • numberOfPages

    số

    Số trang trong tài liệu.

  • máy in

    Máy in

    Thông tin về máy in đã in tài liệu.

  • printer_status

    PrinterStatus

    Chrome 85 trở lên

    Trạng thái của máy in.

  • cài đặt

    PrintSettings

    Chế độ cài đặt của lệnh in.

  • nguồn

    PrintJobSource

    Nguồn cho biết người đã bắt đầu lệnh in.

  • sourceId

    chuỗi không bắt buộc

    Mã nhận dạng của nguồn. Rỗng nếu nguồn là Print_preview hoặc ANDROID_APP.

  • trạng thái

    PrintJobStatus

    Trạng thái cuối cùng của công việc.

  • tiêu đề

    string

    Tiêu đề của tài liệu đã được in.

PrintJobSource

Nguồn của lệnh in.

Enum

"Print_XEM TRƯỚC"
Chỉ định rằng lệnh được tạo từ trang Xem trước bản in do người dùng khởi tạo.

"ANDROID_APP"
Chỉ định rằng công việc được tạo từ Ứng dụng Android.

"EXTENSION"
Chỉ định rằng công việc do tiện ích tạo qua API Chrome.

"ISOLATED_WEB_APP"
Chỉ định rằng công việc do một Ứng dụng web tách biệt tạo ra qua API.

PrintJobStatus

Chỉ định trạng thái cuối cùng của lệnh in.

Enum

"FAILED"
Chỉ định rằng lệnh in bị gián đoạn do một số lỗi.

"ĐÃ HUỶ"
Chỉ định rằng người dùng hoặc API đã huỷ lệnh in.

"PrintED"
Chỉ định rằng lệnh in đã được in mà không có lỗi nào.

PrintSettings

Thuộc tính

  • màu

    ColorMode

    Chế độ màu bạn yêu cầu.

  • bản sao

    số

    Số lượng bản sao được yêu cầu.

  • duplex

    DuplexMode

    Chế độ song công đã yêu cầu.

  • mediaSize

    MediaSize

    Kích thước nội dung nghe nhìn mà bạn yêu cầu.

Phương thức

getPrintJobs()

Lời hứa 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

Trả về danh sách các lệnh in đã hoàn tất.

Tham số

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau: 

    (jobs: PrintJobInfo[]) => void

Giá trị trả về

  • Promise<PrintJobInfo[]>

    Chrome 96 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

Sự kiện

onPrintJobFinished

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

Sự kiện được kích hoạt khi lệnh in hoàn tất. Thông tin này bao gồm mọi trạng thái chấm dứt: KHÔNG THÀNH CÔNG, ĐÃ HUỶ và ĐÃ IN.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau: 

    (jobInfo: PrintJobInfo) => void