chrome.printingMetrics

Description

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

Autorisations

printingMetrics

Garantie de disponibilité

Chrome 79 et versions ultérieures ChromeOS uniquement Règles requises

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

    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.

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

    Imprimante

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

  • printer_status

    PrinterStatus

    Chrome 85 et versions ultérieures

    État de l'imprimante.

  • paramètres

    PrintSettings

    Paramètres de la tâche d'impression.

  • 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.

  • É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

    ColorMode

    Mode couleur demandé.

  • copies

    number

    Nombre de copies demandé.

  • Duplex

    DuplexMode

    Mode duplex demandé.

  • mediaSize

    MediaSize

    Taille du support demandé.

Méthodes

getPrintJobs()

Promesse 
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

Renvoie

  • Promise<PrintJobInfo[]>

    Chrome 96 et versions ultérieures

    Les 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