chrome.printerProvider

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

Autorisations

printerProvider

Disponibilité

Chrome (version 44 ou ultérieure)

Types

PrinterInfo

Propriétés

  • description

    chaîne facultatif

    Description lisible de l'imprimante.

  • id

    chaîne

    ID d'imprimante unique.

  • nom

    chaîne

    Nom lisible de l'imprimante.

PrintError

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

Énumération

"OK"
Spécifie que l'opération s'est terminée correctement.

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

"INVALID_TICKET"
Spécifie que le ticket d'impression n'est pas valide. Par exemple, la demande d'assistance n'est pas compatible avec certaines fonctionnalités, ou l'extension n'est pas en mesure de gérer tous les paramètres de la demande.

"INVALID_DATA"
Spécifie que le document n'est pas valide. Il se peut, par exemple, que les données soient corrompues ou que le format soit 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

    Identifiant de l'imprimante qui doit gérer la tâche.

  • demande

    objet

    Imprimez la demande au format CJT.

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

  • titre

    chaîne

    Intitulé 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

  • rappel

    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

        Capacité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

  • rappel

    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 périphérique USB, qui peut être une imprimante.

Remarque:Une application ne doit pas compter sur le déclenchement de cet événement plusieurs fois par appareil. Si un appareil connecté est compatible, il doit être renvoyé dans l'événement onGetPrintersRequested.

Paramètres

  • rappel

    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 une impression.

Paramètres

  • rappel

    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