chrome.printerProvider

Beschreibung

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

Berechtigungen

printerProvider

Verfügbarkeit

Chrome (ab Version 44)

Typen

PrinterInfo

Attribute

  • Beschreibung

    String optional

    Für Menschen lesbare Beschreibung des Druckers.

  • id

    String

    Eindeutige Drucker-ID.

  • Name

    String

    Der visuell lesbare Name des Druckers.

PrintError

Als Antwort auf das Ereignis onPrintRequested zurückgegebene Fehlercodes.

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. Es kann beispielsweise sein, dass das Ticket nicht mit einigen Funktionen übereinstimmt oder die Erweiterung nicht alle Einstellungen des Tickets verarbeiten kann.

"INVALID_DATA"
Gibt an, dass das Dokument ungültig ist. Es können beispielsweise 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 mit contentType übereinstimmen.

  • printerId

    String

    ID des Druckers, der den Auftrag verarbeiten soll.

  • Ticket

    Objekt

    Drucken Sie das Ticket im CJT-Format aus.

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

  • Titel

    String

    Der Titel des Druckauftrags.

Ereignisse

onGetCapabilityRequested

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

Das Ereignis wird ausgelöst, 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,
)

Das Ereignis wird ausgelöst, 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 (ab Version 45) 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Das Ereignis wird ausgelöst, wenn der Druckmanager Informationen zu einem USB-Gerät anfordert, bei dem es sich möglicherweise um einen Drucker handelt.

Hinweis:Eine App 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,
)

Das Ereignis wird ausgelöst, wenn der Druckmanager den Druck anfordert.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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