browser.printingMetrics

Описание

Используйте API chrome.printingMetrics, чтобы получать данные об использовании принтеров.

Разрешения

printingMetrics

Доступность

Chrome 79 и более поздних версий browser.* начиная с Chrome 148 Только для ChromeOS Требуется правило

Типы

ColorMode

Перечисление

"BLACK_AND_WHITE"
Указывает, что использовался черно-белый режим.

"COLOR"
Указывает, что использовался цветной режим.

DuplexMode

Перечисление

"ONE_SIDED"
Указывает, что использовалась односторонняя печать.

"TWO_SIDED_LONG_EDGE"
Использовалась двусторонняя печать с переплетом по длинному краю.

"TWO_SIDED_SHORT_EDGE"
Двусторонняя печать с переворотом по короткому краю.

MediaSize

Свойства

  • высота

    число

    Высота носителя, используемого для печати, в микрометрах.

  • vendorId

    string

    Идентификатор, предоставленный поставщиком, например "iso_a3_297x420mm" или "na_index-3x5_3x5in". Возможные значения – это значения атрибута IPP media, которые можно найти на странице IANA .

  • ширина

    число

    Ширина носителя, используемого для печати (в микрометрах).

Printer

Свойства

  • name

    string

    Отображаемое название принтера.

  • source

    PrinterSource

    Источник принтера.

  • URI

    string

    Полный путь к принтеру. Содержит протокол, имя хоста, порт и очередь.

PrinterSource

Источник принтера.

Перечисление

"USER"
Принтер добавлен пользователем.

"POLICY"
Принтер добавлен с помощью правила.

PrintJobInfo

Свойства

  • completionTime

    число

    Время завершения задания (в миллисекундах, прошедших с начала эпохи Unix).

  • creationTime

    число

    Время создания задания (в миллисекундах, прошедших с начала эпохи Unix).

  • id

    string

    Идентификатор задания.

  • numberOfPages

    число

    Количество страниц в документе.

  • принтер

    Принтер

    Информация о принтере, на котором был напечатан документ.

  • printer_status

    PrinterStatus

    Chrome 85 и более поздних версий browser.* начиная с Chrome 148

    Статус принтера.

  • настройки

    PrintSettings

    Настройки задания печати.

  • Источник, показывающий, кто инициировал задание печати.

  • sourceId

    Строка (необязательно)

    Идентификатор источника. Если источник – PRINT_PREVIEW или ANDROID_APP, возвращается значение Null.

  • статус

    PrintJobStatus

    Конечный статус задания.

  • название

    string

    Название напечатанного документа.

PrintJobSource

Источник задания печати.

Перечисление

PRINT_PREVIEW
Задание создано на странице предварительного просмотра печати, открытой пользователем.

"ANDROID_APP"
Указывает, что задание было создано из приложения для Android.

"EXTENSION"
Задание создано расширением через Chrome API.

"ISOLATED_WEB_APP"
Указывает, что задание было создано изолированным веб-приложением через API.

PrintJobStatus

Указывает окончательный статус задания печати.

Перечисление

"FAILED"
Задание печати было прервано из-за ошибки.

CANCELED
Задание печати отменено пользователем или через API.

PRINTED
Задание печати выполнено без ошибок.

PrintSettings

Свойства

  • цвет

    ColorMode

    Запрошенный цветовой режим.

  • копии

    число

    Запрошенное количество копий.

  • Дуплекс

    DuplexMode

    Запрошенный режим двусторонней печати.

  • mediaSize

    MediaSize

    Запрошенный размер медиафайла.

Методы

getPrintJobs()

browser.printingMetrics.getPrintJobs(): Promise<PrintJobInfo[]>

Возвращает список завершенных заданий печати.

Возвраты

  • Promise<PrintJobInfo[]>

    Chrome 96 и более поздние версии browser.* начиная с Chrome 148

События

onPrintJobFinished

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

Событие, которое активируется после завершения задания печати. Это относится к любому из статусов завершения: FAILED, CANCELED и PRINTED.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (jobInfo: PrintJobInfo) => void