chrome.printerProvider

refresh date: 2026-09-25 robots: noindex

Description

L'API chrome.printerProvider expose les événements utilisés par le gestionnaire d'impression pour interroger les imprimantes contrôlées par des extensions, interroger leurs fonctionnalités et envoyer des tâches d'impression à ces imprimantes.

Autorisations

printerProvider

Disponibilité

Chrome 44 ou version ultérieure

Types

PrinterInfo

Propriétés

  • description

    chaîne facultatif

    Description de l'imprimante lisible par l'humain.

  • id

    chaîne

    ID d'imprimante unique.

  • nom

    chaîne

    Nom de l'imprimante lisible par l'humain.

PrintError

Codes d'erreur renvoyés en réponse à l'événement onPrintRequested.

Énumération

"OK"
Indique que l'opération a bien été effectuée.

"FAILED"
Indique qu'une défaillance générale s'est produite.

"INVALID_TICKET"
Indique que le ticket d'impression n'est pas valide. Par exemple, le ticket n'est pas compatible avec certaines fonctionnalités, ou l'extension ne peut pas gérer tous les paramètres du ticket.

"INVALID_DATA"
Indique que le document n'est pas valide. Par exemple, les données peuvent être corrompues ou le format peut être incompatible avec l'extension.

PrintJob

Propriétés

  • contentType

    chaîne

    Type de contenu du document. Les formats acceptés sont "application/pdf" et "image/pwg-raster".

  • document

    Blob

    Blob contenant les données du document à imprimer. Le format doit correspondre à contentType.

  • printerId

    chaîne

    ID de l'imprimante qui doit traiter la tâche.

  • demande

    objet

    Ticket d'impression au format CJT.

    La référence CJT est marquée comme obsolète. Elle n'est obsolète que pour Google Cloud Print, pas pour l'impression ChromeOS.

  • titre

    chaîne

    Titre de la tâche d'impression.

Événements

onGetCapabilityRequested

chrome.printerProvider.onGetCapabilityRequested.addListener(
  callback: function,
)

Événement déclenché lorsque le gestionnaire d'impression demande les fonctionnalités de l'imprimante.

Paramètres

  • callback

    fonction

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

    (printerId: string, resultCallback: function) => void

    • printerId

      chaîne

    • resultCallback

      fonction

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

      (capabilities: object) => void

      • capabilities

        objet

        Fonctionnalités de l'appareil au format CDD.

onGetPrintersRequested

chrome.printerProvider.onGetPrintersRequested.addListener(
  callback: function,
)

Événement déclenché lorsque le gestionnaire d'impression demande des imprimantes fournies par des extensions.

Paramètres

  • callback

    fonction

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

    (resultCallback: function) => void

    • resultCallback

      fonction

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

      (printerInfo: PrinterInfo[]) => void

onGetUsbPrinterInfoRequested

Chrome 45 ou version ultérieure 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

Événement déclenché lorsque le gestionnaire d'impression demande des informations sur un appareil USB qui peut être une imprimante.

Remarque : Une application ne doit pas s'attendre à ce que cet événement soit déclenché plus d'une fois par appareil. Si un appareil connecté est compatible, il doit être renvoyé dans l'événement onGetPrintersRequested.

Paramètres

  • callback

    fonction

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

    (device: usb.Device, resultCallback: function) => void

    • appareil

      usb.Device

    • resultCallback

      fonction

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

      (printerInfo?: PrinterInfo) => void

onPrintRequested

chrome.printerProvider.onPrintRequested.addListener(
  callback: function,
)

Événement déclenché lorsque le gestionnaire d'impression demande l'impression.

Paramètres

  • callback

    fonction

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

    (printJob: PrintJob, resultCallback: function) => void

    • printJob

      PrintJob

    • resultCallback

      fonction

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

      (result: PrintError) => void