Description
Utilisez l'API chrome.printingMetrics
pour récupérer les données sur l'utilisation de l'impression.
Autorisations
printingMetrics
Garantie de disponibilité
Types
ColorMode
Enum
"BLACK_AND_WHITE"
Indique que le mode noir et blanc a été utilisé.
"COLOR"
Indique que le mode couleur a été utilisé.
DuplexMode
Enum
"ONE_SIDED"
Indique que l'impression recto verso 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
-
taille
number
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 les valeurs de l'attribut IPP "media" et sont disponibles sur la page de l'IANA .
-
largeur
number
Largeur (en micromètres) du support utilisé pour l'impression.
Printer
Propriétés
-
name
chaîne
Nom de l'imprimante affiché.
-
source
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.
Enum
"USER"
Indique que l'imprimante a été ajoutée par l'utilisateur.
"POLICY"
Indique que l'imprimante a été ajoutée via une règle.
PrintJobInfo
Propriétés
-
completionTime
number
Heure d'achèvement du job (en millisecondes après l'époque Unix).
-
creationTime
number
Durée de création du job (en millisecondes après l'epoch Unix).
-
id
chaîne
ID de la tâche.
-
numberOfPages
number
Nombre de pages du document.
-
imprimante
Informations concernant l'imprimante qui a imprimé le document.
-
printer_statusChrome 85 et versions ultérieures
État de l'imprimante.
-
paramètres
Paramètres de la tâche d'impression.
-
source
Source indiquant l'auteur de la tâche d'impression.
-
sourceId
string facultatif
ID de la source. Valeur nulle si la source est PRINT_PREVIEW ou ANDROID_APP.
-
status
État final de la tâche.
-
title
chaîne
Titre du document imprimé.
PrintJobSource
Source de la tâche d'impression.
Enum
"PRINT_PREVIEW"
Indique que la tâche a été créée à partir de la page d'aperçu avant impression lancée par l'utilisateur.
"ANDROID_APP"
Indique que la tâche a été créée à 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 une API.
PrintJobStatus
Spécifie l'état final de la tâche d'impression.
Enum
"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
Mode couleur demandé.
-
copies
number
Nombre de copies demandé.
-
Duplex
Mode duplex demandé.
-
mediaSize
Taille du support demandé.
Méthodes
getPrintJobs()
chrome.printingMetrics.getPrintJobs(
callback?: function,
)
Renvoie la liste des tâches d'impression terminées.
Paramètres
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(jobs: PrintJobInfo[]) => void
-
jobs
-
Renvoie
-
Promise<PrintJobInfo[]>
Chrome 96 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.
Événements
onPrintJobFinished
chrome.printingMetrics.onPrintJobFinished.addListener(
callback: function,
)
Événement déclenché à la fin de la tâche d'impression. Cela inclut les états de résiliation suivants: ÉCHEC, ANNULÉ et IMPRIMÉ.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(jobInfo: PrintJobInfo) => void
-
jobInfo
-