Descrição
Use a API chrome.printingMetrics
para buscar dados sobre o uso de impressão.
Permissões
printingMetrics
Disponibilidade
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
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
As informações sobre a impressora que imprimiu o documento.
-
printer_statusChrome 85 ou mais recente
O status da impressora.
-
configurações
As configurações do trabalho de impressão.
-
source
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.
-
status
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
O modo de cor solicitado.
-
copia
number
O número solicitado de cópias.
-
Duplex
O modo duplex solicitado.
-
mediaSize
O tamanho da mídia solicitado.
Métodos
getPrintJobs()
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
-
jobs
-
Retorna
-
Promise<PrintJobInfo[]>
Chrome 96 ou mais recentePromessas 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
-
callback
função
O parâmetro
callback
tem esta aparência:(jobInfo: PrintJobInfo) => void
-
jobInfo
-