chrome.printingMetrics

Beschreibung

Verwenden Sie die chrome.printingMetrics API, um Daten zur Drucknutzung abzurufen.

Berechtigungen

printingMetrics

Verfügbarkeit

Chrome 79 oder höher Nur ChromeOS Richtlinie erforderlich

Typen

ColorMode

Enum

"BLACK_AND_WHITE"
Gibt an, dass der Schwarz-Weiß-Modus verwendet wurde.

"COLOR"
Gibt an, dass der Farbmodus verwendet wurde.

DuplexMode

Enum

„ONE_SIDED“
Gibt an, dass einseitiger Druck verwendet wurde.

"TWO_SIDED_LONG_EDGE"
Gibt an, dass der doppelseitige Druck verwendet wurde und das Umblättern an der langen Kante erfolgt ist.

"TWO_SIDED_SHORT_EDGE"
Gibt an, dass beidseitiger Druck verwendet wurde und die Seite an der kurzen Kante gewendet wurde.

MediaSize

Attribute

  • Höhe

    Zahl

    Höhe des für den Druck verwendeten Mediums in Mikrometern.

  • vendorId

    String

    Vom Anbieter bereitgestellte ID, z.B. „iso_a3_297x420mm“ oder „na_index-3x5_3x5in“. Mögliche Werte sind Werte des IPP-Attributs „media“ (Medium). Sie finden sie auf der IANA-Seite.

  • Breite

    Zahl

    Breite des für den Druck verwendeten Mediums in Mikrometern.

Printer

Attribute

  • name

    String

    Der angezeigte Name des Druckers.

  • source

    PrinterSource

    Die Quelle des Druckers.

  • uri

    String

    Der vollständige Pfad zum Drucker. Enthält Protokoll, Hostname, Port und Warteschlange.

PrinterSource

Die Quelle des Druckers.

Enum

„USER“
Gibt an, dass der Drucker vom Nutzer hinzugefügt wurde.

„POLICY“
Gibt an, dass der Drucker über eine Richtlinie hinzugefügt wurde.

PrintJobInfo

Attribute

  • completionTime

    Zahl

    Die Abschlusszeit des Jobs in Millisekunden seit der Unix-Epoche.

  • creationTime

    Zahl

    Die Erstellungszeit des Jobs in Millisekunden seit der Unix-Epoche.

  • id

    String

    Die ID des Jobs.

  • numberOfPages

    Zahl

    Die Anzahl der Seiten im Dokument.

  • drucker

    Drucker

    Informationen zum Drucker, mit dem das Dokument gedruckt wurde.

  • printer_status

    PrinterStatus

    Chrome 85+

    Der Status des Druckers.

  • Einstellungen

    PrintSettings

    Die Einstellungen des Druckauftrags.

  • Quelle, aus der hervorgeht, wer den Druckauftrag initiiert hat.

  • sourceId

    String optional

    ID der Quelle. Null, wenn die Quelle PRINT_PREVIEW oder ANDROID_APP ist.

  • Der endgültige Status des Jobs.

  • Titel

    String

    Der Titel des Dokuments, das gedruckt wurde.

PrintJobSource

Die Quelle des Druckauftrags.

Enum

„PRINT_PREVIEW“
Gibt an, dass der Auftrag auf der vom Nutzer initiierten Seite „Druckvorschau“ erstellt wurde.

„ANDROID_APP“
Gibt an, dass der Job über eine Android-App erstellt wurde.

EXTENSION
Gibt an, dass der Job von einer Erweiterung über die Chrome API erstellt wurde.

ISOLATED_WEB_APP
Gibt an, dass der Job von einer isolierten Web-App über die API erstellt wurde.

PrintJobStatus

Gibt den endgültigen Status des Druckauftrags an.

Enum

„FAILED“
Gibt an, dass der Druckauftrag aufgrund eines Fehlers unterbrochen wurde.

„CANCELED“
Gibt an, dass der Druckauftrag vom Nutzer oder über die API abgebrochen wurde.

„PRINTED“
Gibt an, dass der Druckauftrag fehlerfrei gedruckt wurde.

PrintSettings

Attribute

  • Farbe

    ColorMode

    Der angeforderte Farbmodus.

  • Kopien

    Zahl

    Die angeforderte Anzahl von Kopien.

  • Duplex

    DuplexMode

    Der angeforderte Duplexmodus.

  • mediaSize

    MediaSize

    Die angeforderte Mediengröße.

Methoden

getPrintJobs()

Promise 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

Gibt die Liste der abgeschlossenen Druckaufträge zurück.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (jobs: PrintJobInfo[]) => void

Ausgabe

  • Promise<PrintJobInfo[]>

    Chrome 96 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

Wird ausgelöst, wenn der Druckjob abgeschlossen ist. Dazu gehören alle Kündigungsstatus: FAILED, CANCELED und PRINTED.

Parameter