browser.printingMetrics

Mô tả

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

Quyền

printingMetrics

Phạm vi cung cấp

Trình duyệt Chrome 79 trở lên .* kể từ Chrome 148 Chỉ dành cho ChromeOS Yêu cầu chính sách

Loại

ColorMode

Enum

"BLACK_AND_WHITE"
Chỉ định rằng chế độ đen trắng đã được sử dụng.

"COLOR"
Cho biết chế độ màu đã được sử dụng.

DuplexMode

Enum

"ONE_SIDED"
Chỉ định rằng chế độ in một mặt đã được sử dụng.

"TWO_SIDED_LONG_EDGE"
Chỉ định rằng chế độ in hai mặt đã được sử dụng, lật theo cạnh dài.

"TWO_SIDED_SHORT_EDGE"
Chỉ định rằng chế độ in hai mặt đã được sử dụng, lật theo cạnh ngắn.

MediaSize

Thuộc tính

  • chiều cao

    số

    Chiều cao (tính bằng micromet) của giấy dùng để in.

  • vendorId

    chuỗi

    Mã nhận dạng 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ể sử dụng là giá trị của thuộc tính IPP "media" và có thể tìm thấy trên trang IANA .

  • chiều rộng

    số

    Chiều rộng (tính bằng micromet) của giấy dùng để in.

Printer

Thuộc tính

  • tên

    chuỗi

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

  • source

    Nguồn của máy in.

  • uri

    chuỗi

    Đường dẫn đầy đủ của 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"
Cho biết máy in do người dùng thêm.

"POLICY"
Cho biết 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 sau thời gian Unix).

  • creationTime

    số

    Thời gian tạo công việc (tính bằng mili giây sau thời gian Unix).

  • id

    chuỗi

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

  • numberOfPages

    số

    Số trang trong tài liệu.

  • máy in

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

  • printer_status
    Chrome 85 trở lên trình duyệt.* kể từ Chrome 148

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

  • cài đặt

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

  • 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. Giá trị rỗng nếu nguồn là PRINT_PREVIEW hoặc ANDROID_APP.

  • trạng thái

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

  • tiêu đề

    chuỗi

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

PrintJobSource

Nguồn của lệnh in.

Enum

"PRINT_PREVIEW"
Chỉ định rằng lệnh in được tạo từ trang Xem trước khi in do người dùng khởi tạo.

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

"EXTENSION"
Cho biết rằng công việc được tạo bằng tiện ích thông qua API Chrome.

"ISOLATED_WEB_APP"
Cho biết rằng công việc được tạo bởi một Ứng dụng web tách biệt thông 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.

"CANCELED"
Cho biết lệnh in đã bị người dùng hoặc API huỷ.

"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

    Chế độ màu được yêu cầu.

  • bản sao

    số

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

  • duplex

    Chế độ in hai mặt được yêu cầu.

  • mediaSize

    Kích thước nội dung nghe nhìn được yêu cầu.

Phương thức

getPrintJobs()

browser.printingMetrics.getPrintJobs(): Promise<PrintJobInfo[]>

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

Giá trị trả về

  • Promise<PrintJobInfo[]>

    Chrome 96 trở lên browser.* kể từ Chrome 148

Sự kiện

onPrintJobFinished

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

Sự kiện được kích hoạt khi lệnh in hoàn tất. Bao gồm mọi trạng thái kết thúc: FAILED, CANCELED và PRINTED.

Thông số