chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

说明

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

权限

printerProvider

可用性

Chrome 44 及更高版本

类型

PrinterInfo

属性

  • 说明

    字符串 可选

    打印机的人类可读说明。

  • id

    字符串

    唯一的打印机 ID。

  • name

    字符串

    打印机的人类可读名称。

PrintError

针对 onPrintRequested 事件返回的错误代码。

枚举

“确定”
指定操作已成功完成。

“FAILED”
指定发生了常规故障。

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

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

PrintJob

属性

  • contentType

    字符串

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

  • 文档

    Blob

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

  • printerId

    字符串

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

  • 工单

    对象

    以 CJT 格式打印车票。

    CJT 参考标记为已弃用。仅针对 Google 云打印弃用，未针对 ChromeOS 打印弃用。

  • title

    字符串

    打印任务的名称。

事件

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