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 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 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

    PrinterSource

    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

    Drucker

    Informationen zu dem Drucker, auf dem das Dokument gedruckt wurde.

  • printer_status

    PrinterStatus

    Chrome 85 und höher

    Der Status des Druckers.

  • Einstellungen

    PrintSettings

    Die Einstellungen des Druckauftrags.

  • 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.

  • 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

    ColorMode

    Der angeforderte Farbmodus.

  • Kopien

    Zahl

    Die angeforderte Anzahl von Kopien.

  • Duplex

    DuplexMode

    Der angeforderte Duplexmodus.

  • mediaSize

    MediaSize

    Die angeforderte Mediengröße.

Methoden

getPrintJobs()

Versprechen 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

Parameters

Rückgaben

  • Promise<PrintJobInfo[]>

    Chrome 96 oder höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

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