说明
使用 chrome.printingMetrics API 提取有关打印使用情况的数据。
权限
printingMetrics可用性
类型
ColorMode
枚举
"BLACK_AND_WHITE"
指定使用黑白模式。
"COLOR"
指定使用了颜色模式。
DuplexMode
枚举
"ONE_SIDED"
指定使用单面打印。
"TWO_SIDED_LONG_EDGE"
指定采用双面打印，长边翻转。
"TWO_SIDED_SHORT_EDGE"
指定使用双面打印，短边翻转。
MediaSize
属性
-
高度
number
用于打印的媒介的高度（以微米为单位）。
-
vendorId
string
供应商提供的 ID，例如“iso_a3_297x420mm”或“na_index-3x5_3x5in”。可能的值是“media”IPP 属性的值，可在 IANA 页面上找到。
-
宽度
number
用于打印的媒介的宽度（以微米为单位）。
Printer
属性
-
name
string
打印机的显示名称。
-
source
打印机的来源。
-
uri
string
打印机的完整路径。包含协议、主机名、端口和队列。
PrinterSource
打印机的来源。
枚举
"USER"
指定由用户添加的打印机。
"POLICY"
指定打印机是通过政策添加的。
PrintJobInfo
属性
-
completionTime
number
作业完成时间（以自 Unix 纪元起算的毫秒数表示）。
-
creationTime
number
作业创建时间（以自 Unix 纪元起算的毫秒数表示）。
-
id
string
作业的 ID。
-
numberOfPages
number
文档的页数。
-
打印机
与打印文档的打印机相关的信息。
-
printer_statusChrome 85 及更高版本
打印机的状态。
-
打印作业的设置。
-
source
显示发起打印任务的人员的来源。
-
sourceId
字符串（可选）
来源的 ID。如果来源为 PRINT_PREVIEW 或 ANDROID_APP，则为 null。
-
status
作业的最终状态。
-
title
string
已打印的文档的标题。
PrintJobSource
打印作业的来源。
枚举
"PRINT_PREVIEW"
指定作业是由用户发起的打印预览页创建的。
"ANDROID_APP"
指定作业是从 Android 应用创建的。
"EXTENSION"
指定作业是由扩展程序通过 Chrome API 创建的。
"ISOLATED_WEB_APP"
表示作业是由独立式 Web 应用通过 API 创建的。
PrintJobStatus
指定打印任务的最终状态。
枚举
"FAILED"
指定打印作业因出现错误而中断。
"CANCELED"
指定打印任务已被用户或通过 API 取消。
"PRINTED"
指定打印作业已打印，没有任何错误。
PrintSettings
属性
-
颜色
请求的颜色模式。
-
个副本
number
请求的副本数量。
-
双工
请求的双面模式。
-
mediaSize
请求的媒体尺寸。
方法
getPrintJobs()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
返回已完成的打印作业的列表。
参数
-
callback
函数（可选）
callback参数如下所示：(jobs: PrintJobInfo[])=>void
-
作业
-
返回
-
Promise<PrintJobInfo[]>
Chrome 96 及更高版本Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。
活动
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
打印任务完成时触发的事件。这包括任何终止状态：FAILED、CANCELED 和 PRINTED。
参数
-
callback
功能
callback参数如下所示：(jobInfo: PrintJobInfo)=>void
-
jobInfo
-