chrome.printingMetrics

Descripción

Usa la API de chrome.printingMetrics para recuperar datos sobre el uso de impresiones.

Permisos

printingMetrics

Disponibilidad

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

Tipos

ColorMode

Enum

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

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

DuplexMode

Enum

"ONE_SIDED"
Especifica que se utilizó la impresión unilateral.

"TWO_SIDED_LONG_EDGE"
Especifica que se utilizó una impresión a dos caras, con borde largo.

"TWO_SIDED_SHORT_EDGE"
Especifica que se utilizó una impresión a dos caras, con borde corto.

MediaSize

Propiedades

  • alto

    número

    Es la altura (en micrómetros) del medio que se usa para imprimir.

  • vendorId

    cadena

    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

    Es el ancho (en micrómetros) del medio que se usa para imprimir.

Printer

Propiedades

  • name

    cadena

    Nombre visible de la impresora.

  • source

    PrinterSource

    La fuente de la impresora.

  • uri

    cadena

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

PrinterSource

La fuente de la impresora.

Enum

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

"POLICY"
Especifica que la impresora se agregó mediante una política.

PrintJobInfo

Propiedades

  • completionTime

    número

    El tiempo de finalización del trabajo (en milisegundos después del tiempo Unix).

  • creationTime

    número

    La hora de creación del trabajo (en milisegundos después del tiempo Unix).

  • id

    cadena

    El ID del trabajo.

  • numberOfPages

    número

    Es la cantidad de páginas del documento.

  • impresora

    Impresora

    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

    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 el origen es PRINT_PREVIEW o ANDROID_APP.

  • El estado final del trabajo.

  • title

    cadena

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

PrintJobSource

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ó desde una app para Android.

"EXTENSION"
Especifica que la extensión creó el trabajo mediante la API de Chrome.

"ISOLATED_WEB_APP"
Especifica que el trabajo se creó mediante una app web aislada 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 un error.

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

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

PrintSettings

Propiedades

  • color [color]

    ColorMode

    Es el modo de color solicitado.

  • copias

    número

    Es la cantidad de copias solicitada.

  • Duplex

    DuplexMode

    Es el modo dúplex solicitado.

  • mediaSize

    MediaSize

    Es el tamaño de medios solicitado.

Métodos

getPrintJobs()

Promesa 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

Muestra la lista de los trabajos de impresión terminados.

Parámetros

  • callback

    Función opcional

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

    (jobs: PrintJobInfo[])=>void

Devuelve

  • Promise<PrintJobInfo[]>

    Chrome 96 y versiones posteriores

    Las promesas son compatibles con Manifest V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para brindar retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

Eventos

onPrintJobFinished

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

El evento se activa cuando finaliza el trabajo de impresión. Esto incluye cualquiera de los estados de finalización: FAILED, CANCELED o PRINTED.

Parámetros

  • callback

    la función

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

    (jobInfo: PrintJobInfo)=>void