chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Descripción

La API de chrome.printerProvider expone los eventos que usa el administrador de impresión para consultar las impresoras que controlan las 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

    string opcional

    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 funciones 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 no sea compatible con la extensión.

PrintJob

Propiedades

  • contentType

    string

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

  • documento

    BLOB

    Es el 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 marca como obsoleta. Solo se dejó de usar para Google Cloud Print, pero 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,
)

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

        Funciones del dispositivo en formato CDD

onGetPrintersRequested

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

Es el evento que se activa cuando el administrador de impresión solicita impresoras proporcionadas por 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,
)

Es el 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,
)

Es el evento que se activa cuando el administrador de impresión solicita imprimir.

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