chrome.printingMetrics

refresh date: 2026-09-25 robots: noindex

Opis

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

Uprawnienia

printingMetrics

Dostępność

Chrome 79 lub nowszy Tylko ChromeOS Wymaga zasad

Typy

ColorMode

Typ wyliczeniowy

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

„COLOR”
Określa, że użyto trybu kolorowego.

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

    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.

  • Ostateczny stan 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 na podstawie 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 stan końcowy 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”
Oznacza, że zadanie drukowania zostało wydrukowane bez błędów.

PrintSettings

Właściwości

  • kolor

    ColorMode

    Żądany tryb koloru.

  • 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ę ukończonych zadań drukowania.

Parametry

Zwroty

  • Promise<PrintJobInfo[]>

    Chrome 96 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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