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

属性

  • 高度

    number

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

  • vendorId

    字符串

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

  • width

    number

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

Printer

属性

  • name

    字符串

    显示的打印机名称。

  • 来源

    PrinterSource

    打印机的来源。

  • uri

    字符串

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

PrinterSource

打印机的来源。

枚举

"USER"
表示打印机是由用户添加的。

"POLICY"
表示已通过政策添加打印机。

PrintJobInfo

属性

  • completionTime

    number

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

  • creationTime

    number

    作业创建时间（以自 Unix 纪元以来的毫秒数表示）。

  • id

    字符串

    作业的 ID。

  • numberOfPages

    number

    文档的页数。

  • 打印机

    打印机

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

  • printer_status

    PrinterStatus

    Chrome 85 及更高版本

    打印机的状态。

  • 设置

    PrintSettings

    打印作业的设置。

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

  • 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

属性

  • 颜色

    ColorMode

    请求的颜色模式。

  • 副本

    number

    请求的副本数量。

  • 双工

    DuplexMode

    请求的双工模式。

  • mediaSize

    MediaSize

    请求的媒体尺寸。

方法

getPrintJobs()

<ph type="x-smartling-placeholder"></ph> 承诺 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

参数

返回

  • Promise&lt;PrintJobInfo[]&gt;

    Chrome 96 及更高版本

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

事件

onPrintJobFinished

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

打印作业完成时触发的事件。包括任何终止状态：“失败”“已取消”和“已打印”。

参数