chrome.printingMetrics

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu API chrome.printingMetrics, aby pobrać dane o korzystaniu z funkcji drukowania.

Uprawnienia

printingMetrics

Dostępność

Chrome 79 lub nowsza wersja Tylko ChromeOS Wymaga zasady

Typy

ColorMode

Typ wyliczeniowy

"BLACK_AND_WHITE"
Określa, że użyto trybu czarno-białego.

"COLOR"
Określa, że użyto trybu kolorów.

DuplexMode

Typ wyliczeniowy

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

"TWO_SIDED_LONG_EDGE"
Określa, że użyto drukowania dwustronnego z odwracaniem wzdłuż dłuższej krawędzi.

"TWO_SIDED_SHORT_EDGE"
Określa, że użyto drukowania dwustronnego z odwracaniem wzdłuż krótszej krawędzi.

MediaSize

Właściwości

  • wysokość

    liczba

    Wysokość (w mikrometrach) nośnika używanego do drukowania.

  • vendorId

    tekst

    Identyfikator podany przez dostawcę, np. „iso_a3_297x420mm” lub „na_index-3x5_3x5in”. Możliwe wartości to wartości atrybutu IPP „media”, które można znaleźć na stronie IANA .

  • szerokość

    liczba

    Szerokość (w mikrometrach) nośnika używanego do drukowania.

Printer

Właściwości

  • nazwa

    tekst

    Wyświetlana nazwa drukarki.

  • źródło

    PrinterSource

    Źródło drukarki.

  • uri

    tekst

    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ą zasad.

PrintJobInfo

Właściwości

  • completionTime

    liczba

    Czas zakończenia zadania (w milisekundach od początku epoki uniksowej).

  • creationTime

    liczba

    Czas utworzenia zadania (w milisekundach od początku epoki uniksowej).

  • id

    tekst

    Identyfikator zadania.

  • numberOfPages

    liczba

    Liczba stron w dokumencie.

  • drukarka

    Drukarka

    Informacje o drukarce, na której wydrukowano dokument.

  • printer_status

    PrinterStatus

    Chrome 85 lub nowsza wersja

    Stan drukarki.

  • ustawienia

    PrintSettings

    Ustawienia zadania drukowania.

  • źródło

    PrintJobSource

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

  • sourceId

    ciąg znaków opcjonalny

    Identyfikator źródła. Wartość null, jeśli źródłem jest PRINT_PREVIEW lub ANDROID_APP.

  • Stan końcowy zadania.

  • tytuł

    tekst

    Tytuł wydrukowanego dokumentu.

PrintJobSource

Źródło zadania drukowania.

Typ wyliczeniowy

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

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

"EXTENSION"
Określa, że zadanie zostało utworzone przez rozszerzenie za pomocą interfejsu Chrome API.

"ISOLATED_WEB_APP"
Określa, że zadanie zostało utworzone przez izolowaną aplikację internetową za pomocą 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

    Żądany 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,
): Promise<PrintJobInfo[]>

Zwraca listę zakończonych zadań drukowania.

Parametry

Zwroty

  • Promise<PrintJobInfo[]>

    Chrome 96 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onPrintJobFinished

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

Zdarzenie wywoływane po zakończeniu zadania drukowania. Obejmuje to wszystkie stany zakończenia: FAILED, CANCELED i PRINTED.

Parametry