chrome.printingMetrics

Описание

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

Разрешения

printingMetrics

Доступность

Chrome 79+ Только ChromeOS Требуется политика

Типы

ColorMode

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

"ЧЕРНО_БЕЛЫЙ"
Указывает, что использовался черно-белый режим.

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

DuplexMode

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

"ОДНОСТОРОННИЙ"
Указывает, что использовалась односторонняя печать.

"ДВУХСТОРОННИЙ ДЛИННЫЙ_КРАЙ"
Указывает, что использовалась двусторонняя печать с переворотом по длинной стороне.

"ДВУСТОРОННИЙ_КОРОТКИЙ_КРАЙ"
Указывает, что использовалась двусторонняя печать с переворотом по короткой стороне.

MediaSize

Характеристики

  • высота

    число

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

  • идентификатор поставщика

    нить

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

  • ширина

    число

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

Printer

Характеристики

  • имя

    нить

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

  • источник

    PrinterSource

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

  • ури

    нить

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

PrinterSource

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

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

"ПОЛЬЗОВАТЕЛЬ"
Указывает, что принтер был добавлен пользователем.

"ПОЛИТИКА"
Указывает, что принтер был добавлен через политику.

PrintJobInfo

Характеристики

  • время завершения

    число

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

  • creationTime

    число

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

  • идентификатор

    нить

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

  • количество страниц

    число

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

  • принтер

    Принтер

    Информация о принтере, напечатавшем документ.

  • статус_принтера

    Состояние принтера

    Хром 85+

    Состояние принтера.

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

  • источник

    PrintJobSource

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

  • sourceId

    строка необязательная

    Идентификатор источника. Значение NULL, если источником является PRINT_PREVIEW или ANDROID_APP.

  • статус

    PrintJobStatus

    Окончательный статус работы.

  • заголовок

    нить

    Название документа, который был напечатан.

PrintJobSource

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

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

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

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

"РАСШИРЕНИЕ"
Указывает, что задание было создано расширением через API Chrome.

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

PrintJobStatus

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

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

"НЕУСПЕШНЫЙ"
Указывает, что задание на печать было прервано из-за какой-то ошибки.

«ОТМЕНЕНО»
Указывает, что задание на печать было отменено пользователем или через API.

«ПЕЧАТНО»
Указывает, что задание на печать было напечатано без ошибок.

PrintSettings

Характеристики

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

  • копии

    число

    Запрошенное количество экземпляров.

  • дуплекс

    DuplexMode

    Запрошенный дуплексный режим.

  • mediaSize

    MediaSize

    Запрошенный размер носителя.

Методы

getPrintJobs()

Обещать
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

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

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (jobs: PrintJobInfo[]) => void

Возврат

  • Обещание< PrintJobInfo []>

    Хром 96+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

События

onPrintJobFinished

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

Событие срабатывает при завершении задания печати. Это включает в себя любой из следующих статусов завершения: «ОШИБКА», «ОТМЕНЕНО» и «НАПЕЧАТАНО».

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (jobInfo: PrintJobInfo) => void