chrome.printingMetrics

Description

Utilisez l'API chrome.printingMetrics pour récupérer des données sur l'utilisation de l'impression.

Autorisations

printingMetrics

Disponibilité

Chrome 79 et versions ultérieures ChromeOS uniquement Nécessite une règle

Types

ColorMode

Énumération

"BLACK_AND_WHITE"
Indique que le mode noir et blanc a été utilisé.

"COLOR"
Indique que le mode couleur a été utilisé.

DuplexMode

Énumération

"ONE_SIDED"
Indique qu'une impression recto a été utilisée.

"TWO_SIDED_LONG_EDGE"
Indique que l'impression recto verso a été utilisée, avec retournement sur le bord long.

"TWO_SIDED_SHORT_EDGE"
Indique que l'impression recto verso a été utilisée, avec retournement sur le bord court.

MediaSize

Propriétés

  • hauteur

    Total

    Hauteur (en micromètres) du support utilisé pour l'impression.

  • vendorId

    chaîne

    ID fourni par le fournisseur, par exemple "iso_a3_297x420mm" ou "na_index-3x5_3x5in". Les valeurs possibles sont celles de l'attribut IPP "media". Vous les trouverez sur la page IANA.

  • largeur

    Total

    Largeur (en micromètres) du support utilisé pour l'impression.

Printer

Propriétés

  • nom

    chaîne

    Nom affiché de l'imprimante.

  • source

    PrinterSource

    Source de l'imprimante.

  • uri

    chaîne

    Chemin d'accès complet à l'imprimante. Contient le protocole, le nom d'hôte, le port et la file d'attente.

PrinterSource

Source de l'imprimante.

Énumération

"USER"
Indique que l'imprimante a été ajoutée par un utilisateur.

"POLICY"
Indique que l'imprimante a été ajoutée via une règle.

PrintJobInfo

Propriétés

  • completionTime

    Total

    Heure d'exécution du job (en millisecondes depuis l'epoch Unix).

  • creationTime

    Total

    Heure de création du job (en millisecondes depuis l'epoch Unix).

  • id

    chaîne

    ID de la tâche.

  • numberOfPages

    Total

    Nombre de pages du document.

  • imprimante

    Imprimante

    Informations sur l'imprimante qui a imprimé le document.

  • printer_status

    PrinterStatus

    Chrome 85 ou version ultérieure

    État de l'imprimante.

  • paramètres

    PrintSettings

    Paramètres du job d'impression.

  • Source indiquant qui a lancé le travail d'impression.

  • sourceId

    chaîne facultative

    ID de la source. Null si la source est PRINT_PREVIEW ou ANDROID_APP.

  • État final du job.

  • titre

    chaîne

    Titre du document imprimé.

PrintJobSource

Source de la tâche d'impression.

Énumération

"PRINT_PREVIEW"
Indique que le job a été créé à partir de la page d'aperçu avant impression lancée par l'utilisateur.

"ANDROID_APP"
Indique que le job a été créé à partir d'une application Android.

"EXTENSION"
Indique que le job a été créé par une extension via l'API Chrome.

"ISOLATED_WEB_APP"
Indique que le job a été créé par une application Web isolée via l'API.

PrintJobStatus

Spécifie l'état final du travail d'impression.

Énumération

"FAILED"
Indique que le travail d'impression a été interrompu en raison d'une erreur.

"CANCELED"
indique que la tâche d'impression a été annulée par l'utilisateur ou via l'API.

"PRINTED"
Indique que le travail d'impression a été imprimé sans erreur.

PrintSettings

Propriétés

  • couleur

    ColorMode

    Mode couleur demandé.

  • copies

    Total

    Nombre de copies demandées.

  • Duplex

    DuplexMode

    Mode duplex demandé.

  • mediaSize

    MediaSize

    Taille du média demandée.

Méthodes

getPrintJobs()

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

Renvoie la liste des tâches d'impression terminées.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit : 

    (jobs: PrintJobInfo[]) => void

Renvoie

  • Promise<PrintJobInfo[]>

    Chrome 96 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onPrintJobFinished

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

Événement déclenché lorsque le job d'impression est terminé. Cela inclut tous les états de résiliation : FAILED (ÉCHEC), CANCELED (ANNULÉ) et PRINTED (IMPRIMÉ).

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (jobInfo: PrintJobInfo) => void