chrome.printerProvider

說明

chrome.printerProvider API 會公開列印管理員用來查詢擴充功能控制的印表機的事件，以便查詢擴充功能的功能，以及將列印工作提交給這些印表機。

權限

printerProvider

適用國家/地區

Chrome 44 以上版本

類型

PrinterInfo

屬性

  • description

    字串 選用

    印表機的說明 (使用者可理解)。

  • id

    字串

    專屬印表機 ID。

  • 名稱

    字串

    印表機的人類可讀名稱。

PrintError

回應 onPrintRequested 事件時傳回的錯誤代碼。

列舉

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

"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 參數如下所示： 

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

    • printerId

      字串

    • resultCallback

      功能

      resultCallback 參數如下所示： 

      (capabilities: object)=>void

      • capabilities

        物件

        採用 CDD 格式的裝置功能。

onGetPrintersRequested

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

列印管理員要求擴充功能提供的印表機時會觸發事件。

參數

  • 回呼

    功能

    callback 參數如下所示： 

    (resultCallback: function)=>void

    • resultCallback

      功能

      resultCallback 參數如下所示： 

      (printerInfo: PrinterInfo[])=>void

onGetUsbPrinterInfoRequested

Chrome 45 以上版本 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

列印管理員要求取得 USB 裝置 (可能是印表機) 的相關資訊時，會觸發事件。

注意：應用程式不應仰賴每部裝置重複觸發這個事件一次。如果系統支援已連結的裝置，應在 onGetPrintersRequested 事件中傳回。

參數

  • 回呼

    功能

    callback 參數如下所示： 

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

onPrintRequested

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

列印管理員要求列印時觸發的事件。

參數

  • 回呼

    功能

    callback 參數如下所示： 

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