chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Descripción

La API de chrome.printerProvider expone eventos que usa el administrador de impresión para consultar las impresoras controladas por extensiones, consultar sus capacidades y enviar trabajos de impresión a estas impresoras.

Permisos

printerProvider

Disponibilidad

Chrome 44 y versiones posteriores

Tipos

PrinterInfo

Propiedades

  • descripción

    cadena opcional

    Es la descripción de la impresora legible por humanos.

  • id

    string

    Es el ID único de la impresora.

  • nombre

    string

    Es el nombre de la impresora legible por humanos.

PrintError

Son los códigos de error que se devuelven en respuesta al evento onPrintRequested.

Enum

"OK"
Especifica que la operación se completó correctamente.

"FAILED"
Especifica que se produjo una falla general.

"INVALID_TICKET"
Especifica que el ticket de impresión no es válido. Por ejemplo, el ticket no es coherente con algunas capacidades o la extensión no puede controlar todos los parámetros de configuración del ticket.

"INVALID_DATA"
Especifica que el documento no es válido. Por ejemplo, es posible que los datos estén dañados o que el formato sea incompatible con la extensión.

PrintJob

Propiedades

  • contentType

    string

    Tipo de contenido del documento Los formatos admitidos son "application/pdf" y "image/pwg-raster".

  • documento

    BLOB

    Es un BLOB que contiene los datos del documento que se imprimirá. El formato debe coincidir con contentType.

  • printerId

    string

    Es el ID de la impresora que debe controlar el trabajo.

  • ticket

    objeto

    Imprime el ticket en formato CJT.

    La referencia de CJT se marcó como obsoleta. Está en desuso solo para Google Cloud Print, no para la impresión en ChromeOS.

  • título

    string

    Es el título del trabajo de impresión.

Eventos

onGetCapabilityRequested

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

Evento que se activa cuando el administrador de impresión solicita las capacidades de la impresora.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

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

    • printerId

      string

    • resultCallback

      función

      El parámetro resultCallback se ve de la siguiente manera: 

      (capabilities: object) => void

      • capabilities

        objeto

        Son las capacidades del dispositivo en formato de CDD.

onGetPrintersRequested

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

Evento que se activa cuando el administrador de impresión solicita las impresoras proporcionadas por las extensiones.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

    (resultCallback: function) => void

    • resultCallback

      función

      El parámetro resultCallback se ve de la siguiente manera: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 y versiones posteriores 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Evento que se activa cuando el administrador de impresión solicita información sobre un dispositivo USB que puede ser una impresora.

Nota: Una aplicación no debe depender de que este evento se active más de una vez por dispositivo. Si se admite un dispositivo conectado, se debe devolver en el evento onGetPrintersRequested.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

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

    • dispositivo

      usb.Device

    • resultCallback

      función

      El parámetro resultCallback se ve de la siguiente manera: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

Evento que se activa cuando el administrador de impresión solicita la impresión.

Parámetros

  • callback

    función

    El parámetro callback se ve de la siguiente manera: 

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

    • printJob

      PrintJob

    • resultCallback

      función

      El parámetro resultCallback se ve de la siguiente manera: 

      (result: PrintError) => void