chrome.printerProvider

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 und höher

Typen

PrinterInfo

Attribute

  • Beschreibung

    String optional

    visuell lesbare Beschreibung des Druckers

  • id

    String

    Eindeutige Drucker-ID.

  • name

    String

    visuell lesbarer 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. Es kann beispielsweise sein, dass das Ticket mit einigen Funktionen nicht ü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

    Drucke das Ticket im CJT-Format aus.

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

  • Titel

    String

    Der Titel des Druckauftrags.

Veranstaltungen

onGetCapabilityRequested

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

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

Parameters

  • 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 über Erweiterungen bereitgestellt werden.

Parameters

  • 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,
)

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 nicht davon ausgehen, dass dieses Ereignis mehr als einmal pro Gerät ausgelöst wird. Wenn ein verbundenes Gerät unterstützt wird, sollte es im Ereignis onGetPrintersRequested zurückgegeben werden.

Parameters

  • 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 das Drucken anfordert.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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