chrome.printingMetrics

.

Opis

Użyj interfejsu API chrome.printingMetrics, aby pobrać dane o wykorzystaniu drukowania.

Uprawnienia

printingMetrics

Dostępność

Chrome w wersji 79 lub nowszej Tylko ChromeOS Wymagana zasada

Typy

ColorMode

Typ wyliczeniowy

"BLACK_AND_WHITE"
Określa, że był używany tryb czarno-biały.

"Color"
Określa użyty tryb kolorów.

DuplexMode

Typ wyliczeniowy

"ONE_SIDED"
Określa, że użyto drukowania jednostronnego.

"TWO_SIDED_LONG_EDGE"
Określa, że używane było drukowanie dwustronne z obracaniem dłuższej krawędzi.

"TWO_SIDED_SHORT_EDGE"
Określa, że używane było drukowanie dwustronne z odwracaniem krótszej krawędzi.

MediaSize

Właściwości

  • wysokość

    liczba

    Wysokość (w mikrometrach) nośników używanych do drukowania.

  • vendorId

    ciąg znaków

    Identyfikator podany przez dostawcę, np. "iso_a3_297x420mm" lub „na_index-3x5_3x5in”. Możliwe wartości to „media” na stronie IANA .

  • szerokość

    liczba

    Szerokość (w mikrometrach) nośników używanych do drukowania.

Printer

Właściwości

  • nazwa

    ciąg znaków

    Wyświetlana nazwa drukarki.

  • źródło

    PrinterSource

    Źródło drukarki.

  • identyfikator URI

    ciąg znaków

    Pełna ścieżka drukarki. Zawiera protokół, nazwę hosta, port i kolejkę.

PrinterSource

Źródło drukarki.

Typ wyliczeniowy

"USER"
Określa, że drukarka została dodana przez użytkownika.

"POLICY"
Określa, że drukarka została dodana za pomocą zasady.

PrintJobInfo

Właściwości

  • completionTime

    liczba

    Czas ukończenia zadania (w milisekundach po okresie uniksowym).

  • creationTime

    liczba

    Czas utworzenia zadania (w milisekundach po okresie uniksowym).

  • id

    ciąg znaków

    Identyfikator zadania.

  • numberOfPages

    liczba

    Liczba stron w dokumencie.

  • drukarka

    Drukarka

    Informacje o drukarce, która wydrukowała dokument.

  • printer_status

    PrinterStatus

    Chrome 85 i nowsze .

    Stan drukarki.

  • ustawienia

    PrintSettings

    Ustawienia zadania drukowania.

  • źródło

    PrintJobSource

    Źródło pokazujące, kto zainicjował zadanie drukowania.

  • sourceId

    ciąg znaków opcjonalny

    Identyfikator źródła. Wartość pusta, jeśli źródło to Print_PREVIEW lub ANDROID_APP.

  • Końcowy stan zadania.

  • tytuł

    ciąg znaków

    Tytuł wydrukowanego dokumentu.

PrintJobSource

Źródło zadania drukowania.

Typ wyliczeniowy

"Print_PREVIEW"
Określa, że zadanie zostało utworzone na podstawie strony Podgląd wydruku zainicjowanej przez użytkownika.

"ANDROID_APP"
Określa, że zadanie zostało utworzone w aplikacji na Androida.

"ROZSZERZENIE"
Określa, że zadanie zostało utworzone przez rozszerzenie w interfejsie Chrome API.

"ISOLATED_WEB_APP"
Określa, że zadanie zostało utworzone przez izolowaną aplikację internetową przy użyciu interfejsu API.

PrintJobStatus

Określa ostateczny stan zadania drukowania.

Typ wyliczeniowy

"FAILED"
Określa, że zadanie drukowania zostało przerwane z powodu błędu.

"CANCELED"
Określa, że zadanie drukowania zostało anulowane przez użytkownika lub za pomocą interfejsu API.

"PrintED"
Określa, że zadanie drukowania zostało wydrukowane bez błędów.

PrintSettings

Właściwości

  • kolor

    ColorMode

    Wybrany tryb kolorów.

  • kopie

    liczba

    Żądana liczba kopii.

  • Duplex

    DuplexMode

    Żądany tryb dupleksu.

  • mediaSize

    MediaSize

    Żądany rozmiar multimediów.

Metody

getPrintJobs()

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

Zwraca listę ukończonych zadań drukowania.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (jobs: PrintJobInfo[]) => void
    .

Zwroty

  • Promise<PrintJobInfo[]>

    Chrome w wersji 96 lub nowszej, .

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

Wydarzenia

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

Zdarzenie jest wywoływane po zakończeniu zadania drukowania. Obejmuje to wszystkie stany zamknięcia: NIEPOWODZENIE, ANULOWANE i DRUKOWANE.

Parametry