browser.printerProvider

説明

chrome.printerProvider API は、拡張機能によって制御されるプリンタのクエリ、プリンタの機能のクエリ、プリンタへの印刷ジョブの送信を行うために、プリント マネージャーが使用するイベントを公開します。

権限

printerProvider

対象

Chrome 44 以降 Chrome 148 以降の browser.*

型

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 の印刷では非推奨になりません。

• title

  文字列

  印刷ジョブのタイトル。

イベント

onGetCapabilityRequested

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

印刷マネージャーがプリンタ機能をリクエストしたときに発生するイベント。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

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

  • printerId

    文字列

  • resultCallback

    関数

    resultCallback パラメータは次のようになります。

    (capabilities: object) => void

    • 機能

      オブジェクト

      CDD 形式のデバイス機能。

onGetPrintersRequested

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

印刷マネージャーが拡張機能によって提供されるプリンタをリクエストしたときに発生するイベント。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

  (resultCallback: function) => void

  • resultCallback

    関数

    resultCallback パラメータは次のようになります。

    (printerInfo: PrinterInfo[]) => void

    • printerInfo

      PrinterInfo[]

onGetUsbPrinterInfoRequested

Chrome 45 以降 Chrome 148 以降の browser.*

browser.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

印刷マネージャーが、プリンターの可能性がある USB デバイスに関する情報をリクエストしたときに発生するイベント。

注: アプリケーションは、このイベントがデバイスごとに複数回発生することを前提にしないでください。接続されたデバイスがサポートされている場合は、onGetPrintersRequested イベントで返される必要があります。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

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

  • デバイス

    usb.Device

  • resultCallback

    関数

    resultCallback パラメータは次のようになります。

    (printerInfo?: PrinterInfo) => void

    • printerInfo

      PrinterInfo 省略可

onPrintRequested

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

印刷マネージャーが印刷をリクエストしたときに発生するイベント。

パラメータ

• callback

  関数

  callback パラメータは次のようになります。

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

  • printJob

    PrintJob

  • resultCallback

    関数

    resultCallback パラメータは次のようになります。

    (result: PrintError) => void

    • 件の結果

      PrintError