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 der einseitige Druck verwendet wurde.
"TWO_SIDED_LONG_EDGE"
Gibt an, dass der beidseitige Druck verwendet wurde, wobei an der langen Seite gedreht wird.
"TWO_SIDED_SHORT_EDGE"
Gibt an, dass der beidseitige Druck verwendet wurde, wobei auf der kurzen Seite gedruckt wird.
MediaSize
Attribute
-
Höhe
Zahl
Höhe (in Mikrometern) des zum Drucken verwendeten Mediums.
-
vendorId
String
Vom Anbieter bereitgestellte ID, z.B. „iso_a3_297x420 mm“ oder „na_index-3x5_3x5in“. Mögliche Werte sind Werte von "media" IPP-Attribut. Sie finden es auf der IANA-Seite.
-
Breite
Zahl
Breite (in Mikrometern) des zum Drucken verwendeten Mediums.
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
Der Erstellungszeitpunkt des Jobs (in Millisekunden nach der Unix-Epoche).
-
id
String
Die ID des Jobs.
-
numberOfPages
Zahl
Die Anzahl der Seiten im Dokument.
-
drucker
Die Informationen zu dem Drucker, der das Dokument gedruckt hat.
-
printer_statusChrome (ab Version 85)
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 DR_PREVIEW oder ANDROID_APP ist.
-
Status
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 Druckvorschauseite erstellt wurde, die vom Nutzer initiiert wurde.
"ANDROID_APP"
Gibt an, dass der Job aus einer 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
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.
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(jobs: PrintJobInfo[]) => void
-
Jobs
-
Gibt Folgendes zurück:
-
Promise<PrintJobInfo[]>
Chrome 96 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.
Ereignisse
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
Das Ereignis wird ausgelöst, wenn der Druckauftrag abgeschlossen ist. Dies schließt alle Kündigungsstatus ein: FAILED, CANCELED und PrintED.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(jobInfo: PrintJobInfo) => void
-
jobInfo
-