chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

printerProvider

Доступность

Chrome 44 и более поздних версий;

Типы

PrinterInfo

Свойства

  • описание

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

    Описание принтера, понятное пользователю.

  • id

    string

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

  • name

    string

    Понятное название принтера.

PrintError

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

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

OK
Операция выполнена успешно.

FAILED
Произошла общая ошибка.

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

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

PrintJob

Свойства

  • contentType

    string

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

  • документ;

    BLOB-объект

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

  • printerId

    string

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

  • запрос в службу поддержки : запрос

    Объект

    Билет на печать в формате CJT.

    Ссылка на CJT помечена как устаревшая. Оно прекращено только для Google Виртуального принтера, но не для печати в ChromeOS.

  • название

    string

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

События

onGetCapabilityRequested

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

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

Параметры

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

    function

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

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

    • printerId

      string

    • resultCallback

      function

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

      (capabilities: object) => void

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

        Объект

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

onGetPrintersRequested

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

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

Параметры

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

    function

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

    (resultCallback: function) => void

    • resultCallback

      function

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

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 и более поздних версий; 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

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

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

Параметры

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

    function

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

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

    • устройство

      usb.Device

    • resultCallback

      function

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

      (printerInfo?: PrinterInfo) => void

      • printerInfo

        PrinterInfo необязательный

onPrintRequested

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

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

Параметры

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

    function

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

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

    • printJob

      PrintJob

    • resultCallback

      function

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

      (result: PrintError) => void