chrome.printerProvider

说明

chrome.printerProvider API 提供打印管理器使用的事件，以便查询由扩展程序控制的打印机、查询其功能以及向这些打印机提交打印任务。

权限

printerProvider

可用性

Chrome 44 及更高版本

类型

PrinterInfo

属性

  • 说明

    字符串（可选）

    打印机直观易懂的说明。

  • id

    string

    唯一打印机 ID。

  • name

    string

    打印机直观易读的名称。

PrintError

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

枚举

"OK"
指明操作已成功完成。

"FAILED"
表示发生了常规失败。

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

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

PrintJob

属性

  • contentType

    string

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

  • 文档

    Blob

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

  • printerId

    string

    应处理作业的打印机的 ID。

  • 工单

    对象

    以 CJT 格式打印工单。

    CJT 引用标记为已废弃。此选项仅针对 Google 云打印弃用，不会针对 ChromeOS 打印弃用。

  • title

    string

    打印任务标题。

活动

onGetCapabilityRequested

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

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

参数

  • callback

    功能

    callback 参数如下所示：

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

    • printerId

      string

    • 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