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 <ph type="x-smartling-placeholder"></ph> . Erfordert Richtlinie

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.

&quot;TWO_SIDED_LONG_EDGE&quot;
Gibt an, dass der beidseitige Druck verwendet wurde, wobei an der langen Seite gedreht wird.

&quot;TWO_SIDED_SHORT_EDGE&quot;
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_status
    Chrome (ab Version 85)

    Der Status des Druckers.

  • Einstellungen

    Die Einstellungen des Druckauftrags.

  • Quelle, die angibt, wer den Druckauftrag initiiert hat.

  • sourceId

    String optional

    ID der Quelle. Null, wenn die Quelle DR_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 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.

&quot;ISOLATED_WEB_APP&quot;
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()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (jobs: PrintJobInfo[]) => void

Gibt Folgendes zurück:

  • Promise&lt;PrintJobInfo[]&gt;

    Chrome 96 und höher

    Promise-Objekte 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,
)

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: <ph type="x-smartling-placeholder"></ph>

    (jobInfo: PrintJobInfo) => void