chrome.printerProvider

refresh date: 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