chrome.printingMetrics

Descrição

Use a API chrome.printingMetrics para buscar dados sobre o uso de impressão.

Permissões

printingMetrics

Disponibilidade

Chrome 79+ Apenas no ChromeOS Requer política

Tipos

ColorMode

Tipo enumerado

"BLACK_AND_WHITE"
Especifica que o modo preto e branco foi usado.

"COLOR"
Especifica que o modo de cor foi usado.

DuplexMode

Tipo enumerado

"ONE_SIDED"
Especifica que a impressão unilateral foi usada.

"TWO_SIDED_LONG_EDGE"
Especifica que a impressão frente e verso foi usada, virando na borda longa.

"TWO_SIDED_SHORT_EDGE"
Especifica que a impressão frente e verso foi usada, virando na borda curta.

MediaSize

Propriedades

  • altura

    number

    Altura (em micrômetros) da mídia usada para impressão.

  • vendorId

    string

    ID fornecido pelo fornecedor, por exemplo, "iso_a3_297x420mm" ou "na_index-3x5_3x5in". Os valores possíveis são do atributo "media" de IPP e podem ser encontrados na página da IANA (em inglês).

  • largura

    number

    Largura (em micrômetros) da mídia usada para impressão.

Printer

Propriedades

  • name

    string

    Nome da impressora exibido.

  • source

    PrinterSource

    A origem da impressora.

  • uri

    string

    O caminho completo da impressora. Contém protocolo, nome do host, porta e fila.

PrinterSource

A origem da impressora.

Tipo enumerado

"USER"
Especifica que a impressora foi adicionada pelo usuário.

"POLICY"
especifica que a impressora foi adicionada por meio da política.

PrintJobInfo

Propriedades

  • completionTime

    number

    O tempo de conclusão do job (em milissegundos após a época Unix).

  • creationTime

    number

    A hora de criação do job (em milissegundos após a época Unix).

  • id

    string

    O ID do job.

  • numberOfPages

    number

    O número de páginas do documento.

  • impressora

    Impressora

    As informações sobre a impressora que imprimiu o documento.

  • printer_status

    PrinterStatus

    Chrome 85 ou mais recente

    O status da impressora.

  • configurações

    PrintSettings

    As configurações do trabalho de impressão.

  • Origem mostrando quem iniciou o trabalho de impressão.

  • sourceId

    string opcional

    ID da origem. Nulo se a origem for PRINT_PREVIEW ou ANDROID_APP.

  • O status final do job.

  • title

    string

    O título do documento que foi impresso.

PrintJobSource

A origem do trabalho de impressão.

Tipo enumerado

"PRINT_PREVIEW"
Especifica que a tarefa foi criada na página de visualização da impressão iniciada pelo usuário.

"ANDROID_APP"
Especifica que o job foi criado em um app Android.

"EXTENSÃO"
Especifica que a tarefa foi criada por extensão via API do Google Chrome.

"ISOLATED_WEB_APP"
Especifica que a vaga foi criada por um app da Web isolado via API.

PrintJobStatus

Especifica o status final do trabalho de impressão.

Tipo enumerado

"FALHA"
Especifica que o trabalho de impressão foi interrompido devido a algum erro.

"CANCELED"
Especifica que o trabalho de impressão foi cancelado pelo usuário ou pela API.

"PRINTED"
Especifica que o trabalho de impressão foi impresso sem erros.

PrintSettings

Propriedades

  • cor

    ColorMode

    O modo de cor solicitado.

  • copia

    number

    O número solicitado de cópias.

  • Duplex

    DuplexMode

    O modo duplex solicitado.

  • mediaSize

    MediaSize

    O tamanho da mídia solicitado.

Métodos

getPrintJobs()

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

Retorna a lista dos trabalhos de impressão concluídos.

Parâmetros

  • callback

    função optional

    O parâmetro callback tem esta aparência: 

    (jobs: PrintJobInfo[])=>void

Retorna

  • Promise<PrintJobInfo[]>

    Chrome 96 ou mais recente

    Promessas são compatíveis com o Manifest V3 e versões mais recentes, mas callbacks são fornecidos para compatibilidade com versões anteriores. Não é possível usar os dois na mesma chamada de função. A promessa é resolvida com o mesmo tipo que é passado para o callback.

Eventos

onPrintJobFinished

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

Evento acionado quando o trabalho de impressão é concluído. Isso inclui os status de rescisão: FALHA, CANCELADO e IMPRESSIONADO.

Parâmetros