browser.printingMetrics

Beschreibung

Mit der chrome.printingMetrics API können Sie Daten zur Druckernutzung abrufen.

Berechtigungen

printingMetrics

Verfügbarkeit

Chrome 79+ browser.* seit Chrome 148 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 einseitig gedruckt wurde.

"TWO_SIDED_LONG_EDGE"
Gibt an, dass der Druck beidseitig erfolgt ist, wobei die Seiten an der langen Kante gewendet wurden.

"TWO_SIDED_SHORT_EDGE"
Gibt an, dass beidseitig gedruckt wurde, wobei die Seiten an der kurzen Kante gewendet wurden.

MediaSize

Attribute

  • Höhe

    Zahl

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

  • 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“. Sie finden sie auf der IANA-Seite.

  • Breite

    Zahl

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

Printer

Attribute

  • name

    String

    Anzeigename des Druckers.

  • Quelle

    Die Quelle des Druckers.

  • uri

    String

    Der vollständige Pfad für den 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 Zeit, zu der der Job abgeschlossen wurde (in Millisekunden seit der Unix-Epoche).

  • creationTime

    Zahl

    Der Zeitpunkt der Joberstellung (in Millisekunden nach der Unix-Epoche).

  • id

    String

    Die ID des Jobs.

  • numberOfPages

    Zahl

    Die Anzahl der Seiten im Dokument.

  • drucker

    Informationen zum Drucker, der das Dokument gedruckt hat.

  • printer_status
    Chrome 85 und höher browser.* seit Chrome 148

    Der Status des Druckers.

  • Einstellungen

    Die Einstellungen des Druckauftrags.

  • Quelle, die zeigt, 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 gedruckten Dokuments.

PrintJobSource

Die Quelle des Druckauftrags.

Enum

"PRINT_PREVIEW"
Gibt an, dass der Auftrag über die vom Nutzer initiierte Seite „Druckvorschau“ erstellt wurde.

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

"EXTENSION"
Gibt an, dass der Job über die Chrome API von einer Erweiterung 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 ohne Fehler gedruckt wurde.

PrintSettings

Attribute

  • Farbe

    Der angeforderte Farbmodus.

  • Kopien

    Zahl

    Die angeforderte Anzahl von Kopien.

  • Duplex

    Der angeforderte Duplexmodus.

  • mediaSize

    Die angeforderte Mediengröße.

Methoden

getPrintJobs()

browser.printingMetrics.getPrintJobs(): Promise<PrintJobInfo[]>

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

Ausgabe

  • Promise<PrintJobInfo[]>

    Chrome 96+ browser.* seit Chrome 148

Ereignisse

onPrintJobFinished

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

Ereignis, das ausgelöst wird, wenn der Druckauftrag abgeschlossen ist. Dazu gehören die Beendigungsstatus FAILED, CANCELED und PRINTED.

Parameter