chrome.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 a essas impressoras.

Permissões

printerProvider

Disponibilidade

Chrome 44 ou superior

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 de erro retornados em resposta ao evento onPrintRequested.

Enumeração

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

"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 é capaz de lidar com 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 é 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 contendo os dados do documento a ser impresso. O formato precisa corresponder a contentType.

  • printerId

    string

    ID da impressora que deverá executar o trabalho.

  • tíquete

    objeto

    Imprimir o tíquete no formato CJT.

    A referência do CJT foi marcada como descontinuada. Ele está obsoleto apenas para o Google Cloud Print. não foi descontinuada para a impressão do 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 os 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 gerente 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 superior 
chrome.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: é recomendado que o aplicativo não dependa 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 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