chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Descrição

A API chrome.printerProvider expõe eventos usados pelo gerenciador de impressão para consultar impressoras controladas por extensões, consultar os recursos delas e enviar trabalhos de impressão para essas impressoras.

Permissões

printerProvider

Disponibilidade

Chrome 44 ou mais recente

Tipos

PrinterInfo

Propriedades

  • descrição

    string opcional

    Descrição legível da impressora.

  • ID

    string

    ID exclusivo da impressora.

  • nome

    string

    Nome legível da impressora.

PrintError

Códigos de erro retornados em resposta ao evento onPrintRequested.

Enumeração

"OK"
Especifica que a operação foi concluída com sucesso.

"FAILED"
Especifica que ocorreu uma falha geral.

"INVALID_TICKET"
Especifica que o tíquete de impressão é inválido. Por exemplo, o tíquete é inconsistente com alguns recursos ou a extensão não consegue processar todas as configurações do tíquete.

"INVALID_DATA"
Especifica que o documento é inválido. Por exemplo, os dados podem estar corrompidos ou o formato pode ser incompatível com a extensão.

PrintJob

Propriedades

  • contentType

    string

    O tipo de conteúdo do documento. Os formatos aceitos são "application/pdf" e "image/pwg-raster".

  • documento

    Blob

    Blob que contém os dados do documento a serem impressos. O formato precisa ser contentType.

  • printerId

    string

    ID da impressora que vai processar o job.

  • tíquete

    objeto

    Imprima o tíquete no formato CJT.

    A referência da CJT está marcada como descontinuada. Ela foi descontinuada apenas para o Google Cloud Print, não para a impressão no ChromeOS.

  • título

    string

    O título do trabalho de impressão.

Eventos

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

Evento disparado quando o gerenciador de impressão solicita recursos da impressora.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (printerId: string, resultCallback: function) => void

    • printerId

      string

    • resultCallback

      função

      O parâmetro resultCallback tem esta aparência: 

      (capabilities: object) => void

      • capabilities

        objeto

        Recursos do dispositivo no formato CDD.

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

Evento disparado quando o gerenciador de impressão solicita impressoras fornecidas por extensões.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (resultCallback: function) => void

    • resultCallback

      função

      O parâmetro resultCallback tem esta aparência: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 ou mais recente 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Evento disparado quando o gerenciador de impressão solicita informações sobre um dispositivo USB que pode ser uma impressora.

Observação:um aplicativo não deve depender de que esse evento seja acionado mais de uma vez por dispositivo. Se um dispositivo conectado for compatível, ele será retornado no evento onGetPrintersRequested.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (device: usb.Device, resultCallback: function) => void

    • dispositivo

      usb.Device

    • resultCallback

      função

      O parâmetro resultCallback tem esta aparência: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

Evento disparado quando o gerenciador de impressão solicita a impressão.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      função

      O parâmetro resultCallback tem esta aparência: 

      (result: PrintError) => void