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 les extensions, pour interroger leurs fonctionnalités et pour envoyer des tâches d'impression à ces imprimantes.

Autorisations

printerProvider

Disponibilité

Chrome 44 et versions ultérieures

Types

PrinterInfo

Propriétés

  • description

    chaîne facultatif

    Description de l'imprimante lisible par l'utilisateur.

  • id

    chaîne

    ID unique de l'imprimante.

  • nom

    chaîne

    Nom de l'imprimante lisible par l'utilisateur.

PrintError

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

Énumération

"OK"
indique que l'opération a été effectuée avec succès.

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

"INVALID_TICKET"
Indique que le bon d'impression n'est pas valide. Par exemple, la demande n'est pas cohérente avec certaines fonctionnalités ou l'extension n'est pas en mesure de gérer tous les paramètres de la demande.

"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 le job.

  • demande

    objet

    Imprimez le billet au format CJT.

    La référence CJT est marquée comme obsolète. Elle est obsolète uniquement pour Google Cloud Print, et non 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 les imprimantes fournies par les 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 et versions ultérieures 
chrome.printerProvider.onGetUsbPrinterInfoRequested.addListener(
  callback: function,
)

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

Remarque : Une application ne doit pas s'attendre à ce que cet événement soit déclenché plusieurs 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