chrome.printerProvider

更新日: 2026-09-25 robots: noindex

説明

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

  • title

    文字列

    印刷ジョブのタイトル。

イベント

onGetCapabilityRequested

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

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

パラメータ

  • callback

    関数

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

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

    • printerId

      文字列

    • resultCallback

      関数

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

      (capabilities: object) => void

      • 機能

        オブジェクト

        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

    • デバイス

      usb.Device

    • resultCallback

      関数

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

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

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

パラメータ

  • callback

    関数

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

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

    • printJob

      PrintJob

    • resultCallback

      関数

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

      (result: PrintError) => void