chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Beschreibung

Die chrome.printerProvider API stellt Ereignisse bereit, die vom Druckmanager verwendet werden, um von Erweiterungen gesteuerte Drucker abzufragen, ihre Funktionen abzufragen und Druckaufträge an diese Drucker zu senden.

Berechtigungen

printerProvider

Verfügbarkeit

Chrome 44 oder höher

Typen

PrinterInfo

Attribute

  • Beschreibung

    String optional

    Menschenlesbare Beschreibung des Druckers.

  • id

    String

    Eindeutige Drucker-ID.

  • name

    String

    Menschenlesbarer Name des Druckers.

PrintError

Fehlercodes, die als Antwort auf das Ereignis onPrintRequested zurückgegeben werden.

Enum

"OK"
Gibt an, dass der Vorgang erfolgreich abgeschlossen wurde.

"FAILED"
Gibt an, dass ein allgemeiner Fehler aufgetreten ist.

"INVALID_TICKET"
Gibt an, dass das Druckticket ungültig ist. Beispielsweise ist das Ticket mit einigen Funktionen nicht kompatibel oder die Erweiterung kann nicht alle Einstellungen aus dem Ticket verarbeiten.

"INVALID_DATA"
Gibt an, dass das Dokument ungültig ist. Beispielsweise können Daten beschädigt sein oder das Format ist nicht mit der Erweiterung kompatibel.

PrintJob

Attribute

  • contentType

    String

    Der Inhaltstyp des Dokuments. Unterstützte Formate sind "application/pdf" und "image/pwg-raster".

  • Dokument

    Blob

    Blob mit den zu druckenden Dokumentdaten. Das Format muss contentType entsprechen.

  • printerId

    String

    ID des Druckers, der den Job verarbeiten soll.

  • Ticket

    Objekt

    Druckticket im CJT-Format.

    Die CJT-Referenz ist als veraltet markiert. Sie wurde nur für Google Cloud Print eingestellt, nicht für das Drucken mit ChromeOS.

  • Titel

    String

    Der Titel des Druckauftrags.

Ereignisse

onGetCapabilityRequested

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

Ereignis, das ausgelöst wird, wenn der Druckmanager Druckerfunktionen anfordert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • printerId

      String

    • resultCallback

      Funktion

      Der Parameter resultCallback sieht so aus: 

      (capabilities: object) => void

      • capabilities

        Objekt

        Gerätefunktionen im CDD-Format.

onGetPrintersRequested

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

Ereignis, das ausgelöst wird, wenn der Druckmanager Drucker anfordert, die von Erweiterungen bereitgestellt werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (resultCallback: function) => void

    • resultCallback

      Funktion

      Der Parameter resultCallback sieht so aus: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 oder höher 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Ereignis, das ausgelöst wird, wenn der Druckmanager Informationen zu einem USB-Gerät anfordert, bei dem es sich um einen Drucker handeln könnte.

Hinweis: Eine Anwendung sollte sich nicht darauf verlassen, dass dieses Ereignis mehr als einmal pro Gerät ausgelöst wird. Wenn ein verbundenes Gerät unterstützt wird, sollte es im onGetPrintersRequested-Ereignis zurückgegeben werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onPrintRequested

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

Ereignis, das ausgelöst wird, wenn der Druckmanager einen Druckvorgang anfordert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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