chrome.printingMetrics

Descrição

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

Permissões

printingMetrics

Disponibilidade

Chrome 79 ou superior Somente ChromeOS Requer política

Tipos

ColorMode

Enumeração

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

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

DuplexMode

Enumeração

"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 a borda longa.

"TWO_SIDED_SHORT_EDGE"
Especifica que a impressão frente e verso foi usada, virando a 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 "media" IPP e pode ser encontrado na página da IANA .

  • largura

    number

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

Printer

Propriedades

  • nome

    string

    Nome exibido da impressora.

  • source

    PrinterSource

    A fonte da impressora.

  • uri

    string

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

PrinterSource

A fonte da impressora.

Enumeração

"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 do Unix).

  • creationTime

    number

    O horário de criação do job (em milissegundos após a época do 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 superior

    Status da impressora.

  • configurações

    PrintSettings

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

  • Fonte que mostra 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.

  • título

    string

    O título do documento que foi impresso.

PrintJobSource

A origem do trabalho de impressão.

Enumeração

"PRINT_PREVIEW"
Especifica que a tarefa foi criada a partir da página "Visualizar impressão" iniciada pelo usuário.

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

"EXTENSION"
Especifica que o job foi criado por extensão via API do Google Chrome.

"ISOLATED_WEB_APP"
Especifica que o job foi criado por um App da Web Isolado via API.

PrintJobStatus

Especifica o status final do trabalho de impressão.

Enumeração

"FAILED"
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 por uma 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 de trabalhos de impressão concluídos.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (jobs: PrintJobInfo[]) => void

Retorna

  • Promise<PrintJobInfo[]>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

Eventos

onPrintJobFinished

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

Evento disparado quando o trabalho de impressão é concluído. Isso inclui os status de encerramento: FALHA, CANCELADO e IMPRESSO.

Parâmetros