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 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

  • name

    string

    Nome legível da impressora.

PrintError

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

Tipo enumerado

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

"FALHA"
Especifica que ocorreu uma falha geral.

"INVALID_TICKET"
Especifica que o tíquete de impressão é inválido. Por exemplo, o tíquete está inconsistente com alguns recursos ou a extensão não consegue 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 compatíveis são "application/pdf" e "image/pwg-raster".

  • documento

    Blob

    Blob contendo os dados do documento a serem impressos. O formato precisa corresponder a contentType.

  • printerId

    string

    ID da impressora responsável pelo trabalho.

  • tíquete

    objeto

    Imprimir o tíquete no formato CJT.

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

  • title

    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 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 acionado quando o gerenciador de impressão solicita informações sobre um dispositivo USB que pode ser uma impressora.

Observação:os aplicativos não podem confiar que esse evento seja disparado mais de uma vez por dispositivo. Se houver suporte para um dispositivo conectado, 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