chrome.printingMetrics

Descrizione

Utilizza l'API chrome.printingMetrics per recuperare i dati sull'utilizzo della stampa.

Autorizzazioni

printingMetrics

Disponibilità

Chrome 79 e versioni successive Solo ChromeOS Richiede un criterio

Tipi

ColorMode

Enum

"BLACK_AND_WHITE"
Specifica che è stata utilizzata la modalità in bianco e nero.

"COLOR"
Specifica che è stata utilizzata la modalità colore.

DuplexMode

Enum

"ONE_SIDED"
Specifica che è stata utilizzata la stampa su un solo lato.

"TWO_SIDED_LONG_EDGE"
Specifica che è stata utilizzata la stampa fronte/retro, con rotazione sul lato lungo.

"TWO_SIDED_SHORT_EDGE"
Specifica che è stata utilizzata la stampa fronte/retro, con rotazione sul lato corto.

MediaSize

Proprietà

  • altezza

    numero

    Altezza (in micrometri) del supporto utilizzato per la stampa.

  • vendorId

    stringa

    ID fornito dal fornitore, ad esempio "iso_a3_297x420mm" o "na_index-3x5_3x5in". I valori possibili sono i valori dell'attributo IPP "media" e sono disponibili nella pagina IANA .

  • larghezza

    numero

    Larghezza (in micron) del supporto utilizzato per la stampa.

Printer

Proprietà

  • nome

    stringa

    Nome visualizzato della stampante.

  • origine

    PrinterSource

    L'origine della stampante.

  • uri

    stringa

    Il percorso completo della stampante. Contiene protocollo, nome host, porta e coda.

PrinterSource

L'origine della stampante.

Enum

"USER"
Specifica che la stampante è stata aggiunta dall'utente.

"POLICY"
Specifica che la stampante è stata aggiunta tramite le norme.

PrintJobInfo

Proprietà

  • completionTime

    numero

    L'ora di completamento del job (in millisecondi dopo l'epoca Unix).

  • creationTime

    numero

    L'ora di creazione del job (in millisecondi dopo l'epoca di Unix).

  • id

    stringa

    L'ID del job.

  • numberOfPages

    numero

    Il numero di pagine del documento.

  • stampante

    Stampante

    Informazioni sulla stampante che ha stampato il documento.

  • printer_status

    PrinterStatus

    Chrome 85+

    Lo stato della stampante.

  • impostazioni

    PrintSettings

    Le impostazioni del lavoro di stampa.

  • origine

    PrintJobSource

    L'origine che mostra chi ha avviato il processo di stampa.

  • sourceId

    stringa facoltativa

    ID dell'origine. Null se l'origine è PRINT_PREVIEW o ANDROID_APP.

  • Lo stato finale del job.

  • titolo

    stringa

    Il titolo del documento stampato.

PrintJobSource

L'origine del processo di stampa.

Enum

"PRINT_PREVIEW"
Specifica che il lavoro è stato creato dalla pagina Anteprima di stampa avviata dall'utente.

"ANDROID_APP"
Specifica che il lavoro è stato creato da un'app per Android.

"EXTENSION"
Specifica che il job è stato creato dall'estensione tramite l'API Chrome.

"ISOLATED_WEB_APP"
Specifica che il job è stato creato da un'app web isolata tramite API.

PrintJobStatus

Specifica lo stato finale del processo di stampa.

Enum

"NON RIUSCITO"
Specifica che il processo di stampa è stato interrotto a causa di un errore.

"ANNULLATO"
Specifica che il processo di stampa è stato annullato dall'utente o tramite API.

"STAMPATO"
Specifica che il processo di stampa è stato stampato senza errori.

PrintSettings

Proprietà

  • colore

    ColorMode

    La modalità colore richiesta.

  • copie

    numero

    Il numero di copie richiesto.

  • duplex

    DuplexMode

    La modalità duplex richiesta.

  • mediaSize

    MediaSize

    Le dimensioni del contenuto multimediale richiesto.

Metodi

getPrintJobs()

Promessa 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
): Promise<PrintJobInfo[]>

Restituisce l'elenco dei job di stampa completati.

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (jobs: PrintJobInfo[]) => void

Resi

  • Promise<PrintJobInfo[]>

    Chrome 96+

    Le promesse sono supportate solo per Manifest V3 e versioni successive, le altre piattaforme devono utilizzare i callback.

Eventi

onPrintJobFinished

chrome.printingMetrics.onPrintJobFinished.addListener(
  callback: function,
)

Evento attivato al termine del job di stampa. Sono inclusi tutti gli stati di risoluzione: FAILED, CANCELED e PRINTED.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (jobInfo: PrintJobInfo) => void