chrome.printerProvider

Descrizione

L'API chrome.printerProvider espone gli eventi utilizzati da Gestione stampa per interrogare le 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 biglietto cartaceo non è valido. Ad esempio, il ticket non è coerente con alcune funzionalità o 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. È deprecata solo per Google Cloud Print. non è deprecata per la stampa di ChromeOS.

  • titolo

    stringa

    Il titolo del processo di stampa.

Eventi

onGetCapabilityRequested

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

L'evento viene attivato quando Gestione 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

        Capacità del dispositivo in formato CDD.

onGetPrintersRequested

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

L'evento 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 Gestione 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