chrome.printingMetrics

说明

使用 chrome.printingMetrics API 获取有关打印使用情况的数据。

权限

printingMetrics

可用性

Chrome 79 及更高版本 仅限 ChromeOS 需要政策

类型

ColorMode

枚举

“BLACK_AND_WHITE”
指定使用了黑白模式。

“COLOR”
指定使用了颜色模式。

DuplexMode

枚举

“ONE_SIDED”
指定使用了单面打印。

"TWO_SIDED_LONG_EDGE"
指定使用了双面打印，并沿长边翻转。

"TWO_SIDED_SHORT_EDGE"
指定使用了双面打印，并沿短边翻转。

MediaSize

属性

  • 高度

    数值

    用于打印的介质的高度（以微米为单位）。

  • vendorId

    字符串

    供应商提供的 ID，例如“iso_a3_297x420mm”或“na_index-3x5_3x5in”。可能的值是“media”IPP 属性的值，可在 IANA 页面上找到。

  • width

    数值

    用于打印的介质的宽度（以微米为单位）。

Printer

属性

  • name

    字符串

    打印机的显示名称。

  • 来源

    PrinterSource

    打印机的来源。

  • uri

    字符串

    打印机的完整路径。包含协议、主机名、端口和队列。

PrinterSource

打印机的来源。

枚举

“USER”
指定打印机是由用户添加的。

“POLICY”
指定打印机是通过政策添加的。

PrintJobInfo

属性

  • completionTime

    数值

    作业完成时间（自 Unix 纪元以来经过的毫秒数）。

  • creationTime

    数值

    作业创建时间（以毫秒为单位，从 Unix 纪元开始计算）。

  • id

    字符串

    作业的 ID。

  • numberOfPages

    数值

    文档中的页数。

  • 打印机

    打印机

    打印相应文档的打印机的相关信息。

  • printer_status

    PrinterStatus

    Chrome 85 及更高版本

    打印机的状态。

  • 设置

    PrintSettings

    打印作业的设置。

  • 显示谁发起了打印作业的来源。

  • sourceId

    字符串（选填）

    来源的 ID。如果来源为 PRINT_PREVIEW 或 ANDROID_APP，则为 null。

  • 作业的最终状态。

  • title

    字符串

    已打印文档的标题。

PrintJobSource

打印作业的来源。

枚举

“PRINT_PREVIEW”
指定作业是从用户启动的“打印预览”页面创建的。

“ANDROID_APP”
指定作业是从 Android 应用创建的。

“EXTENSION”
指定作业是由扩展程序通过 Chrome API 创建的。

“ISOLATED_WEB_APP”
指定作业是由独立式 Web 应用通过 API 创建的。

PrintJobStatus

指定打印作业的最终状态。

枚举

“FAILED”
指定打印作业因某些错误而中断。

“CANCELED”
表示打印作业已由用户或通过 API 取消。

“PRINTED”
表示打印作业已完成打印，未出现任何错误。

PrintSettings

属性

  • 颜色

    ColorMode

    所请求的颜色模式。

  • 副本

    数值

    请求的副本数量。

  • 双工

    DuplexMode

    所请求的双工模式。

  • mediaSize

    MediaSize

    请求的媒体大小。

方法

getPrintJobs()

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

返回已完成的打印作业列表。

参数

返回

  • Promise<PrintJobInfo[]>

    Chrome 96 及更高版本

    仅 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

事件

onPrintJobFinished

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

打印作业完成时触发的事件。这包括任何终止状态：FAILED、CANCELED 和 PRINTED。

参数