chrome.printingMetrics

Description

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

Autorisations

printingMetrics

Disponibilité

Chrome 79 et versions ultérieures ChromeOS uniquement <ph type="x-smartling-placeholder"></ph> Règle obligatoire

Types

ColorMode

Énumération

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

"COLOR"
Spécifie que le mode couleur a été utilisé.

DuplexMode

Énumération

"ONE_SIDED"
Spécifie que l'impression recto verso a été utilisée.

&quot;TWO_SIDED_LONG_EDGE&quot;
Spécifie que l'impression recto verso a été utilisée, en les retournant sur le bord long.

&quot;TWO_SIDED_SHORT_EDGE&quot;
Spécifie que l'impression recto verso a été utilisée, en retournant sur le bord court.

MediaSize

Propriétés

  • hauteur

    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 les valeurs "media" IPP et sont disponibles sur la page de l'IANA .

  • largeur

    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"
Spécifie que l'imprimante a été ajoutée par l'utilisateur.

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

PrintJobInfo

Propriétés

  • completionTime

    Nombre

    Heure d'exécution de la tâche (en millisecondes après l'époque Unix).

  • creationTime

    Nombre

    Heure de création de la tâche (en millisecondes après l'époque 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 l'auteur de la tâche d'impression.

  • sourceId

    chaîne facultatif

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

  • État final de la tâche.

  • titre

    chaîne

    Titre du document imprimé.

PrintJobSource

Source de la tâche d'impression.

Énumération

"PRINT_PREVIEW"
Spécifie que la tâche a été créée à partir de la page "Aperçu avant impression" lancée par l'utilisateur.

"ANDROID_APP"
Spécifie que la tâche a été créée à partir d'une application Android.

"EXTENSION"
Spécifie que la tâche a été créée par une extension via l'API Chrome.

&quot;ISOLATED_WEB_APP&quot;
Spécifie que l'offre d'emploi a été créée par une application Web isolée via l'API.

PrintJobStatus

Indique l'état final de la tâche d'impression.

Énumération

"FAILED"
Spécifie que la tâche d'impression a été interrompue en raison d'une erreur.

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

"IMPRIMÉ"
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é.

  • Duplex

    DuplexMode

    Mode duplex demandé.

  • mediaSize

    MediaSize

    Taille du support demandée.

Méthodes

getPrintJobs()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.printingMetrics.getPrintJobs(
  callback?: function,
)

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

Paramètres

  • rappel

    function facultatif

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

    (jobs: PrintJobInfo[]) => void

Renvoie

  • Promise&lt;PrintJobInfo[]&gt;

    Chrome 96 ou version ultérieure

    Les promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La 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 l'un des états d'arrêt suivants: ÉCHEC, ANNULÉ ou IMPRIMÉ.

Paramètres

  • rappel

    fonction

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

    (jobInfo: PrintJobInfo) => void