chrome.printingMetrics

Opis

Używaj interfejsu API chrome.printingMetrics do pobierania danych o drukowaniu.

Uprawnienia

printingMetrics

Dostępność

Chrome 79 i nowsze Tylko ChromeOS Wymaga zasad

Typy

ColorMode

Enum

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

"COLOR"
Określa używany tryb koloru.

DuplexMode

Enum

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

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

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

MediaSize

Właściwości

  • wysokość

    Liczba

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

  • vendorId

    string,

    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śników używanych do drukowania.

Printer

Właściwości

  • nazwa

    string,

    Wyświetlana nazwa drukarki.

  • source

    PrinterSource

    Źródło drukarki.

  • uri

    string,

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

PrinterSource

Źródło drukarki.

Enum

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

"POLICY"
Określa, że drukarka została dodana przez zasadę.

PrintJobInfo

Właściwości

  • completionTime

    Liczba

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

  • creationTime

    Liczba

    Czas utworzenia zadania (w milisekundach po czasie uniksowym).

  • id

    string,

    Identyfikator zadania.

  • numberOfPages

    Liczba

    Liczba stron w dokumencie.

  • drukarka

    Drukarka

    Informacje o drukarce, na której wydrukowano dokument.

  • printer_status

    PrinterStatus

    Chrome 85 i nowsze wersje

    Stan drukarki.

  • ustawienia

    PrintSettings

    Ustawienia zadania drukowania.

  • Źródło pokazują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.

  • title

    string,

    Tytuł wydrukowanego dokumentu.

PrintJobSource

Źródło zadania drukowania.

Enum

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

"ANDROID_APP"
Wskazuje, że zadanie zostało utworzone w aplikacji na Androida.

"EXTENSION"
Określa, że zadanie zostało utworzone przez rozszerzenie przy użyciu interfejsu Chrome API.

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

PrintJobStatus

Określa końcowy stan zadania drukowania.

Enum

„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 przez interfejs API.

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

PrintSettings

Właściwości

  • kolor

    ColorMode

    Wybrany 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,
)

Zwraca listę zakończonych zadań drukowania.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (jobs: PrintJobInfo[])=>void

Akcje powrotne

  • Promise<PrintJobInfo[]>

    Chrome 96 i nowsze wersje

    Obietnice są obsługiwane w platformie Manifest V3 i nowszych, ale wywołania zwrotne są dostępne na potrzeby zgodności wstecznej. Nie można użyć obu w tym samym wywołaniu funkcji. Obietnica znika z tym samym typem, który jest przekazywany do wywołania zwrotnego.

Wydarzenia

onPrintJobFinished

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

Zdarzenie wywoływane po zakończeniu zadania drukowania. Obejmuje to wszystkie stany zakończenia subskrypcji: NIEPOWODNY, ANULOWANO i WYDRUKOWANO.

Parametry