chrome.printerProvider

说明

chrome.printerProvider API 公开了打印管理器用于查询由扩展程序控制的打印机、查询其功能以及向这些打印机提交打印作业的事件。

权限

printerProvider

可用性

Chrome 44 及更高版本

类型

PrinterInfo

属性

  • 说明

    字符串（可选）

    打印机的直观易懂的说明。

  • id

    字符串

    唯一打印机 ID。

  • name

    字符串

    打印机的人类可读名称。

PrintError

为响应 onPrintRequested 事件而返回的错误代码。

枚举

"OK"
表示操作已成功完成。

"FAILED"
表示发生了常规故障。

"INVALID_TICKET"
指定打印票券无效。例如，支持服务工单与某些功能不一致，或者扩展程序无法处理工单中的所有设置。

"INVALID_DATA"
指定文档无效。例如，数据可能已损坏，或者格式与扩展程序不兼容。

PrintJob

属性

  • contentType

    字符串

    文档内容类型。支持的格式为 "application/pdf" 和 "image/pwg-raster"。

  • 文档

    Blob

    包含要打印的文档数据的 Blob。格式必须与“contentType”一致。

  • printerId

    字符串

    负责处理该作业的打印机的 ID。

  • 工单

    对象

    以 CJT 格式打印工单。

    CJT 引用被标记为已弃用。此功能仅可用于 Google 云打印。未针对 ChromeOS 打印而弃用。

  • 标题

    字符串

    打印作业标题。

事件

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

打印管理器请求打印机功能时会触发事件。

参数

  • callback

    函数

    callback 参数如下所示： 

    (printerId: string, resultCallback: function) => void

    • printerId

      字符串

    • resultCallback

      函数

      resultCallback 参数如下所示： 

      (capabilities: object) => void

      • capabilities

        对象

        设备功能，采用 CDD 格式。

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

打印管理器请求扩展程序提供的打印机时会触发事件。

参数

  • callback

    函数

    callback 参数如下所示： 

    (resultCallback: function) => void

    • resultCallback

      函数

      resultCallback 参数如下所示： 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 及更高版本 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

打印管理器请求有关可能是打印机的 USB 设备的信息时会触发事件。

注意：应用不应期望此事件在每台设备上触发多次。如果已连接的设备受支持，则应在 onGetPrintersRequested 事件中返回相应设备。

参数

  • callback

    函数

    callback 参数如下所示： 

    (device: usb.Device, resultCallback: function) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

打印管理器请求打印时触发的事件。

参数

  • callback

    函数

    callback 参数如下所示： 

    (printJob: PrintJob, resultCallback: function) => void