chrome.printingMetrics

дата обновления: 2026-09-25 robots: noindex

Описание

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

Разрешения

printingMetrics

Доступность

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

Типы

ColorMode

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

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

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

DuplexMode

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

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

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

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

MediaSize

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

  • высота

    число

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

  • vendorId

    нить

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

  • ширина

    число

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

Printer

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

  • имя

    нить

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

  • источник

    PrinterSource

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

  • ури

    нить

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

PrinterSource

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

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

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

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

PrintJobInfo

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

  • completionTime

    число

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

  • время создания

    число

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

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

    нить

    Идентификатор вакансии.

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

    число

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

  • принтер

    Принтер

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

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

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

    Chrome 85+

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

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

  • источник

    PrintJobSource

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

  • sourceId

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

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

  • статус

    PrintJobStatus

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

  • заголовок

    нить

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

PrintJobSource

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

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

"ПРЕДПРОСМОТР ДЛЯ ПЕЧАТИ"
Указывает, что задание было создано на странице предварительного просмотра печати, инициированной пользователем.

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

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

"ИЗОЛИРОВАННОЕ ВЕБ-ПРИЛОЖЕНИЕ"
Указывает, что задание было создано изолированным веб-приложением через API.

PrintJobStatus

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

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

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

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

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

PrintSettings

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

Методы

getPrintJobs()

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

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

Параметры

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

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

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

    (jobs: PrintJobInfo[]) => void

Возвраты

  • Promise< PrintJobInfo []>

    Chrome 96+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

События

onPrintJobFinished

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

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

Параметры

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

    функция

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

    (jobInfo: PrintJobInfo) => void