chrome.printerProvider

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

Описание

API chrome.printerProvider предоставляет события, используемые менеджером печати для запроса информации о принтерах, управляемых расширениями, для запроса их возможностей и для отправки заданий на печать этим принтерам.

Разрешения

printerProvider

Доступность

Chrome 44+

Типы

PrinterInfo

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

  • описание

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

    Удобочитаемое описание, предоставленное принтером.

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

    нить

    Уникальный идентификатор принтера.

  • имя

    нить

    Имя типографа, читаемое человеком.

PrintError

Коды ошибок, возвращаемые в ответ на событие onPrintRequested .

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

"ХОРОШО"
Указывает на то, что операция была успешно завершена.

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

"INVALID_TICKET"
Указывает на недействительность заявки на печать. Например, заявка не соответствует некоторым возможностям, или расширение не может обработать все настройки из заявки.

"INVALID_DATA"
Указывает на недействительность документа. Например, данные могут быть повреждены или формат несовместим с расширением.

PrintJob

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

  • contentType

    нить

    Тип содержимого документа. Поддерживаемые форматы: "application/pdf" и "image/pwg-raster" .

  • документ

    Клякса

    Объект типа BLOB, содержащий данные документа для печати. ​​Формат должен соответствовать contentType ).

  • printerId

    нить

    Идентификатор принтера, который должен выполнить задание.

  • билет

    объект

    Распечатайте билет в формате CJT .

    Ссылка на CJT помечена как устаревшая. Она устарела только для Google Cloud Print. Для печати в ChromeOS она не устарела.

  • заголовок

    нить

    Название задания на печать.

События

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

Событие срабатывает, когда менеджер печати запрашивает возможности принтера.

Параметры

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

    функция

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

    (printerId: string, resultCallback: function) => void

    • printerId

      нить

    • resultCallback

      функция

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

      (capabilities: object) => void

      • возможности

        объект

        Возможности устройства в формате CDD .

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

Событие срабатывает, когда менеджер печати запрашивает принтеры, предоставленные расширениями.

Параметры

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

    функция

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

    (resultCallback: function) => void

onGetUsbPrinterInfoRequested

Chrome 45+
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Событие срабатывает, когда менеджер печати запрашивает информацию о USB-устройстве, которое может быть принтером.

Примечание: Приложение не должно полагаться на то, что это событие будет срабатывать более одного раза для каждого устройства. Если подключенное устройство поддерживается, его следует вернуть в событии onGetPrintersRequested .

Параметры

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

    функция

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

    (device: usb.Device, resultCallback: function) => void

    • устройство

      USB-устройство

    • resultCallback

      функция

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

      (printerInfo?: PrinterInfo) => void

      • Информация о принтере

        PrinterInfo ( необязательно)

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

Событие срабатывает, когда менеджер печати запрашивает печать.

Параметры

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

    функция

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

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      функция

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

      (result: PrintError) => void