chrome.printingMetrics

Descripción

Usa la API de chrome.printingMetrics para recuperar datos sobre el uso de la impresión.

Permisos

printingMetrics

Disponibilidad

Chrome 79 y versiones posteriores Solo para ChromeOS Requiere política

Tipos

ColorMode

Enum

"BLACK_AND_WHITE"
Especifica que se usó el modo en blanco y negro.

"COLOR"
Especifica que se usó el modo de color.

DuplexMode

Enum

"ONE_SIDED"
Especifica que se usó la impresión a una cara.

"TWO_SIDED_LONG_EDGE"
Especifica que se usó la impresión a doble cara, con el borde largo como eje de giro.

"TWO_SIDED_SHORT_EDGE"
Especifica que se usó la impresión a doble cara, con el giro en el borde corto.

MediaSize

Propiedades

  • alto

    número

    Altura (en micrómetros) del medio utilizado para la impresión.

  • vendorId

    string

    Es el ID proporcionado por el proveedor, p.ej., "iso_a3_297x420mm" o "na_index-3x5_3x5in". Los valores posibles son los del atributo IPP "media" y se pueden encontrar en la página de IANA .

  • ancho

    número

    Ancho (en micrómetros) del medio utilizado para la impresión.

Printer

Propiedades

  • nombre

    string

    Es el nombre visible de la impresora.

  • source

    PrinterSource

    Es la fuente de la impresora.

  • uri

    string

    Es la ruta de acceso completa de la impresora. Contiene el protocolo, el nombre de host, el puerto y la cola.

PrinterSource

Es la fuente de la impresora.

Enum

"USER"
Especifica que el usuario agregó la impresora.

"POLICY"
Especifica que la impresora se agregó a través de una política.

PrintJobInfo

Propiedades

  • completionTime

    número

    Es la hora de finalización del trabajo (en milisegundos transcurridos desde la época de Unix).

  • creationTime

    número

    Es la fecha y hora de creación del trabajo (en milisegundos transcurridos desde la época de Unix).

  • id

    string

    El ID del trabajo.

  • numberOfPages

    número

    Es la cantidad de páginas del documento.

  • impresora

    Impresora

    Es la información sobre la impresora que imprimió el documento.

  • printer_status

    PrinterStatus

    Chrome 85 y versiones posteriores

    Es el estado de la impresora.

  • configuración

    PrintSettings

    Es la configuración del trabajo de impresión.

  • Fuente que muestra quién inició el trabajo de impresión.

  • sourceId

    cadena opcional

    Es el ID de la fuente. Es nulo si la fuente es PRINT_PREVIEW o ANDROID_APP.

  • Es el estado final del trabajo.

  • título

    string

    Es el título del documento que se imprimió.

PrintJobSource

Es la fuente del trabajo de impresión.

Enum

"PRINT_PREVIEW"
Especifica que el trabajo se creó desde la página de vista previa de impresión que inició el usuario.

"ANDROID_APP"
Especifica que el trabajo se creó a partir de una app para Android.

"EXTENSION"
Especifica que la extensión creó el trabajo a través de la API de Chrome.

"ISOLATED_WEB_APP"
Especifica que una app web aislada creó el trabajo a través de la API.

PrintJobStatus

Especifica el estado final del trabajo de impresión.

Enum

"FAILED"
Especifica que el trabajo de impresión se interrumpió debido a algún error.

"CANCELED"
Especifica que el usuario o la API cancelaron el trabajo de impresión.

"PRINTED"
Especifica que el trabajo de impresión se imprimió sin errores.

PrintSettings

Propiedades

  • color

    ColorMode

    Es el modo de color solicitado.

  • copias

    número

    Es la cantidad de copias solicitadas.

  • Duplex

    DuplexMode

    Es el modo dúplex solicitado.

  • mediaSize

    MediaSize

    Es el tamaño de los medios solicitado.

Métodos

getPrintJobs()

Promesa 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

Devuelve la lista de los trabajos de impresión finalizados.

Parámetros

  • callback

    función opcional

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

    (jobs: PrintJobInfo[]) => void

Muestra

Eventos

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

Evento que se activa cuando finaliza el trabajo de impresión. Esto incluye cualquiera de los estados de finalización: FAILED, CANCELED y PRINTED.

Parámetros

  • callback

    función

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

    (jobInfo: PrintJobInfo) => void