chrome.printerProvider

Descripción

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

    string opcional

    Descripción legible por humanos de la impresora.

  • id

    string

    ID de impresora único.

  • nombre

    string

    Es el nombre de la impresora en lenguaje natural.

PrintError

Códigos de error que se muestran 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 cumple con algunas capacidades, o bien la extensión no puede procesar 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

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

  • printerId

    string

    ID de la impresora que debe procesar el trabajo.

  • ticket

    objeto

    Imprimir el ticket en formato CJT

    La referencia de CJT se marcó como obsoleta. Solo está obsoleto para Google Cloud Print. no está obsoleto para la impresión de ChromeOS.

  • título

    string

    El título del trabajo de impresión.

Eventos

onGetCapabilityRequested

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

El evento se activa cuando el administrador de impresiones solicita capacidades de 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

        Capacidades del dispositivo en formato CDD.

onGetPrintersRequested

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

El evento se activa cuando el administrador de impresiones 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,
)

El evento se activa cuando el administrador de impresiones 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 un dispositivo conectado es compatible, se debe mostrar 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,
)

El evento se activa cuando el administrador de impresiones solicita impresiones.

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