chrome.printerProvider

Aktualisierungsdatum: 2026-09-25 robots: noindex

Beschreibung

Die chrome.printerProvider API macht Ereignisse verfügbar, 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 und höher

Typen

PrinterInfo

Attribute

  • Beschreibung

    String optional

    Menschenlesbare Beschreibung des Druckers.

  • id

    String

    Eindeutige Drucker-ID.

  • name

    String

    Für Menschen lesbarer Name des Druckers.

PrintError

Fehlercodes, die als Reaktion 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. Das Ticket ist beispielsweise nicht mit einigen Funktionen 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

    Drucken Sie das Ticket im CJT-Format.

    Die CJT-Referenz ist als veraltet markiert. Sie wurde nur für Google Cloud Print eingestellt, nicht für das Drucken unter 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 von Erweiterungen bereitgestellte Drucker anfordert.

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 und höher 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Ereignis, das ausgelöst wird, wenn der Druckmanager Informationen zu einem USB-Gerät anfordert, das möglicherweise ein Drucker ist.

Hinweis:Eine Anwendung sollte nicht darauf angewiesen sein, 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