chrome.printerProvider

Descrizione

L'API chrome.printerProvider mostra gli eventi utilizzati dal gestore di stampa per eseguire query sulle stampanti controllate da estensioni, per eseguire query sulle loro funzionalità e per inviare processi di stampa a queste stampanti.

Autorizzazioni

printerProvider

Disponibilità

Chrome 44 e versioni successive

Tipi

PrinterInfo

Proprietà

  • descrizione

    stringa facoltativo

    Descrizione leggibile della stampante.

  • id

    stringa

    ID stampante univoco.

  • nome

    stringa

    Nome leggibile della stampante.

PrintError

Codici di errore restituiti in risposta all'evento onPrintRequested.

Enum

"OK"
Specifica che l'operazione è stata completata correttamente.

"FAILED"
Specifica che si è verificato un errore generale.

"INVALID_TICKET"
Specifica che il ticket di stampa non è valido. Ad esempio, il ticket non è coerente con alcune funzionalità oppure l'estensione non è in grado di gestire tutte le impostazioni del ticket.

"INVALID_DATA"
Specifica che il documento non è valido. Ad esempio, i dati potrebbero essere danneggiati o il formato non è compatibile con l'estensione.

PrintJob

Proprietà

  • contentType

    stringa

    Il tipo di contenuti del documento. I formati supportati sono "application/pdf" e "image/pwg-raster".

  • documento

    Blob

    Blob contenente i dati del documento da stampare. Il formato deve corrispondere a: contentType.

  • printerId

    stringa

    ID della stampante che dovrebbe gestire il processo.

  • biglietto

    oggetto

    Stampa il biglietto in formato CJT.

    Il riferimento CJT è contrassegnato come deprecato. È deprecato solo per Google Cloud Print e non è deprecato per la stampa ChromeOS.

  • title

    stringa

    Il titolo del processo di stampa.

Eventi

onGetCapabilityRequested

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

L'evento viene attivato quando il gestore di stampa richiede le funzionalità della stampante.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • printerId

      stringa

    • resultCallback

      funzione

      Il parametro resultCallback ha il seguente aspetto: 

      (capabilities: object)=>void

      • capabilities

        oggetto

        Funzionalità del dispositivo in formato CDD.

onGetPrintersRequested

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

Evento che viene attivato quando il gestore di stampa richiede le stampanti fornite dalle estensioni.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (resultCallback: function)=>void

    • resultCallback

      funzione

      Il parametro resultCallback ha il seguente aspetto: 

      (printerInfo: PrinterInfo[])=>void

onGetUsbPrinterInfoRequested

Chrome 45 e versioni successive 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

L'evento viene attivato quando il gestore di stampa richiede informazioni su un dispositivo USB che potrebbe essere una stampante.

Nota:un'applicazione non deve basarsi sul fatto che questo evento venga attivato più di una volta per dispositivo. Se un dispositivo connesso è supportato, deve essere restituito nell'evento onGetPrintersRequested.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • dispositivo

      usb.Device

    • resultCallback

      funzione

      Il parametro resultCallback ha il seguente aspetto: 

      (printerInfo?: PrinterInfo)=>void

onPrintRequested

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

L'evento viene attivato quando il gestore di stampa richiede la stampa.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • printJob

      PrintJob

    • resultCallback

      funzione

      Il parametro resultCallback ha il seguente aspetto: 

      (result: PrintError)=>void