browser.printerProvider

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+ browser.* desde o Chrome 148

Tipos

PrinterInfo

Propriedades

  • descrição

    string opcional

    Descrição legível por humanos da impressora.

  • ID

    string

    ID exclusivo da impressora.

  • nome

    string

    Nome legível da impressora.

PrintError

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

Enumeração

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

"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 corresponder a contentType.

  • printerId

    string

    ID da impressora que deve processar o trabalho.

  • tíquete

    objeto

    Imprima o tíquete no formato CJT.

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

  • título

    string

    O título do trabalho de impressão.

Eventos

onGetCapabilityRequested

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

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

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

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

    • printerId

      string

    • resultCallback

      função

      O parâmetro resultCallback é semelhante a: 

      (capabilities: object) => void

      • capabilities

        objeto

        Recursos do dispositivo no formato CDD.

onGetPrintersRequested

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

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

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (resultCallback: function) => void

    • resultCallback

      função

      O parâmetro resultCallback é semelhante a: 

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45+ browser.* desde o Chrome 148 
browser.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Evento acionado 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 do acionamento desse evento 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 é semelhante a: 

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

    • dispositivo

      usb.Device

    • resultCallback

      função

      O parâmetro resultCallback é semelhante a: 

      (printerInfo?: PrinterInfo) => void

onPrintRequested

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

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

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

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

    • printJob

      PrintJob

    • resultCallback

      função

      O parâmetro resultCallback é semelhante a: 

      (result: PrintError) => void