chrome.printingMetrics

refresh date: 2026-09-25 robots: noindex

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ỉ 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 dùng.

DuplexMode

Enum

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

"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 micrômet) của giấy in được 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ể 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 micrômet) của giấy in được dùng để in.

Printer

Thuộc tính

  • tên

    chuỗi

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

  • source

    PrinterSource

    Nguồn của máy in.

  • uri

    chuỗi

    Đườ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"
Cho biết rằng người dùng đã thêm máy in.

"POLICY"
Cho biết 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 kể từ 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 kể từ thời gian bắt đầu của hệ thống Unix).

  • id

    chuỗi

    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 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

    PrintJobStatus

    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"
Chỉ định rằng công việc được tạo bởi tiện ích thông qua Chrome API.

"ISOLATED_WEB_APP"
Chỉ định 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"
Cho biết rằng lệnh in bị gián đoạn do xảy ra lỗi.

"CANCELED"
Chỉ định rằng người dùng đã huỷ lệnh in hoặc huỷ thông qua API.

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

PrintSettings

Thuộc tính

  • màu

    ColorMode

    Chế độ màu được 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 được yêu cầu.

  • mediaSize

    MediaSize

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

Phương thức

getPrintJobs()

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

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

Thông số

  • callback

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

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

    (jobs: PrintJobInfo[]) => void

Giá trị trả về

  • Promise<PrintJobInfo[]>

    Chrome 96 trở lên

    Chỉ Manifest V3 trở lên mới hỗ trợ Promise, các nền tảng khác cần sử dụng 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. Điều này bao gồm mọi trạng thái kết thúc: THẤT BẠI, ĐÃ HUỶ và ĐÃ IN.

Thông số