chrome.printingMetrics

Aktualisierungsdatum: 2026-09-25 robots: noindex

Beschreibung

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

Berechtigungen

printingMetrics

Verfügbarkeit

Chrome 79 und 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 zweiseitiger Druck verwendet wurde und das Papier entlang der langen Kante gewendet wurde.

"TWO_SIDED_SHORT_EDGE"
Gibt an, dass zweiseitiger Druck verwendet wurde und das Wenden entlang der kurzen Kante erfolgte.

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“ (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.

  • Quelle

    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 nach 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, die angibt, wer den Druckauftrag gestartet 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 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 ohne Fehler 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,
)

Ereignis, das ausgelöst wird, wenn der Druckauftrag abgeschlossen ist. Dazu gehören alle Kündigungsstatus: FAILED, CANCELED und PRINTED.

Parameter