说明
使用 chrome.printingMetrics API 提取有关打印使用情况的数据。
权限
printingMetrics可用性
类型
ColorMode
枚举
"BLACK_AND_WHITE"
指定使用黑白模式。
"COLOR"
指定使用了颜色模式。
DuplexMode
枚举
"ONE_SIDED"
指定使用单面打印。
"TWO_SIDED_LONG_EDGE"
指定使用双面打印，将长边翻转。
"TWO_SIDED_SHORT_EDGE"
指定使用双面打印，短边翻转。
MediaSize
属性
-
高度
number
打印介质的高度（以微米为单位）。
-
vendorId
字符串
供应商提供的 ID，例如“iso_a3_297x420mm”或“na_index-3x5_3x5in”。可能的值为“media”IPP 属性，可在 IANA 页面中找到。
-
width
number
用于打印的介质的宽度（以微米为单位）。
Printer
属性
-
name
字符串
显示的打印机名称。
-
打印机的来源。
-
uri
字符串
打印机的完整路径。包含协议、主机名、端口和队列。
PrinterSource
打印机的来源。
枚举
"USER"
表示打印机是由用户添加的。
"POLICY"
表示已通过政策添加打印机。
PrintJobInfo
属性
-
completionTime
number
作业完成时间（以自 Unix 纪元以来的毫秒数表示）。
-
creationTime
number
作业创建时间（以自 Unix 纪元以来的毫秒数表示）。
-
id
字符串
作业的 ID。
-
numberOfPages
number
文档的页数。
-
打印机
打印文档的打印机的相关信息。
-
printer_statusChrome 85 及更高版本
打印机的状态。
-
打印作业的设置。
-
显示发起打印作业的人的来源。
-
sourceId
字符串（可选）
来源的 ID。如果来源为 PRINT_PREVIEW 或 ANDROID_APP，则返回 null。
-
作业的最终状态。
-
标题
字符串
已打印文档的标题。
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,
)
打印作业完成时触发的事件。包括任何终止状态：“失败”“已取消”和“已打印”。
参数
-
callback
函数
callback参数如下所示：(jobInfo: PrintJobInfo) => void
-
jobInfo
-