Beschreibung
Verwenden Sie die chrome.printingMetrics
API, um Daten zur Drucknutzung abzurufen.
Berechtigungen
printingMetrics
Verfügbarkeit
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 beidseitiger Druck verwendet wurde, wobei die lange Seite umgedreht wurde.
"TWO_SIDED_SHORT_EDGE"
Gibt an, dass beidseitiger Druck verwendet wurde, wobei die kurze Seite gedreht wurde.
MediaSize
Attribute
-
Höhe
Zahl
Höhe (in Mikrometern) des Mediums, das für den Druck verwendet wird.
-
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 Mikrometer) des Mediums, das für den Druck verwendet wird.
Printer
Attribute
-
name
String
Angezeigter Name des Druckers
-
source
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 Abschlusszeit des Jobs (in Millisekunden nach der Unix-Epoche).
-
creationTime
Zahl
Die Erstellungszeit des Jobs (in Millisekunden nach der Unix-Epoche).
-
id
String
Die ID des Jobs.
-
numberOfPages
Zahl
Die Anzahl der Seiten im Dokument.
-
drucker
Informationen zu dem Drucker, auf dem das Dokument gedruckt wurde.
-
printer_statusChrome 85 und höher
Der Status des Druckers.
-
Einstellungen
Die Einstellungen des Druckauftrags.
-
source
Quelle, die angibt, wer den Druckauftrag initiiert hat.
-
sourceId
String optional
ID der Quelle. Null, wenn die Quelle {/1}DRUCK_PREVIEW oder ANDROID_APP lautet.
-
status
Der endgültige Status des Jobs.
-
Titel
String
Der Titel des gedruckten Dokuments.
PrintJobSource
Die Quelle des Druckauftrags.
Enum
"DRUCK_PREVIEW"
Gibt an, dass der Auftrag über die vom Nutzer initiierte Druckvorschauseite erstellt wurde.
"ANDROID_APP"
Gibt an, dass der Job in einer Android-App erstellt wurde.
"EXTENSION"
Gibt an, dass der Job von der Erweiterung über die Chrome API erstellt wurde.
"ISOLATED_WEB_APP"
Gibt an, dass der Job von einer isolierten Web-App über eine API erstellt wurde.
PrintJobStatus
Gibt den endgültigen Status des Druckauftrags an.
Enum
"FAILED"
Gibt an, dass der Druckauftrag aufgrund eines Fehlers unterbrochen wurde.
"ABGEBROCHEN"
Gibt an, dass der Druckauftrag vom Nutzer oder über die API abgebrochen wurde.
"DRUCK"
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()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
Gibt die Liste der abgeschlossenen Druckaufträge zurück.
Parameters
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(jobs: PrintJobInfo[]) => void
-
Jobs
-
Rückgaben
-
Promise<PrintJobInfo[]>
Chrome 96 oder höherPromise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.
Veranstaltungen
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
Das Ereignis wird ausgelöst, wenn der Druckauftrag abgeschlossen ist. Dazu gehören Beendigungsstatus: FEHLGESCHLAGEN, STORNIERT und GEDRUCKT.
Parameters
-
callback
Funktion
Der Parameter
callback
sieht so aus:(jobInfo: PrintJobInfo) => void
-
jobInfo
-