chrome.printingMetrics

refresh date: 2026-09-25 robots: noindex

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 que l'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

  • height

    nombre

    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 de l'IANA.

  • width

    nombre

    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

    nombre

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

  • creationTime

    nombre

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

  • id

    chaîne

    ID de la tâche.

  • numberOfPages

    nombre

    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 de la tâche d'impression.

  • Source indiquant qui a lancé la tâche d'impression.

  • sourceId

    chaîne facultatif

    ID de la source. Nul 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 "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 de la tâche d'impression.

Énumération

"FAILED"
Indique que la tâche d'impression a été interrompue 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 la tâche d'impression a été imprimée sans erreur.

PrintSettings

Propriétés

  • couleur

    ColorMode

    Mode couleur demandé.

  • copies

    nombre

    Nombre de copies demandées.

  • Duplex

    DuplexMode

    Mode duplex demandé.

  • mediaSize

    MediaSize

    Taille du contenu multimé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 la tâche d'impression est terminée. Cela inclut tous les états de résiliation : ÉCHEC, ANNULÉ et IMPRIMÉ.

Paramètres

  • callback

    fonction

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

    (jobInfo: PrintJobInfo) => void