chrome.printerProvider

Descripción

La API de chrome.printerProvider expone los eventos que usa el administrador de impresiones 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

    La descripción legible de la impresora.

  • id

    cadena

    ID de impresora único.

  • name

    cadena

    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 es coherente con algunas capacidades o la extensión no puede controlar toda la 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

    cadena

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

  • documento

    BLOB

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

  • printerId

    cadena

    ID de la impresora que debe realizar el trabajo.

  • ticket

    objeto

    Imprime el ticket en formato CJT.

    La referencia de CJT está marcada como obsoleta. Está obsoleto solo para Google Cloud Print y no está obsoleto para la impresión de ChromeOS.

  • title

    cadena

    Es 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 las capacidades de las impresoras.

Parámetros

  • callback

    la función

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

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

    • printerId

      cadena

    • resultCallback

      la 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,
)

El evento se activa cuando el administrador de impresiones solicita las impresoras proporcionadas por extensiones.

Parámetros

  • callback

    la función

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

    (resultCallback: function)=>void

    • resultCallback

      la 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,
)

Este 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 debería depender de que este evento se active más de una vez por dispositivo. Si se admite un dispositivo conectado, se debe mostrar en el evento onGetPrintersRequested.

Parámetros

  • callback

    la función

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

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

    • dispositivo
    • resultCallback

      la función

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

      (printerInfo?: PrinterInfo)=>void

onPrintRequested

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

Se activó el evento cuando el administrador de impresiones solicitaba la impresión.

Parámetros

  • callback

    la función

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

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

    • printJob
    • resultCallback

      la función

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

      (result: PrintError)=>void