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

Autorisations

printerProvider

Garantie de disponibilité

Chrome 44 ou version ultérieure

Types

PrinterInfo

Propriétés

  • description

    string facultatif

    Description de l'imprimante lisible par l'humain.

  • id

    chaîne

    Identifiant unique de l'imprimante.

  • name

    chaîne

    Nom lisible de l'imprimante.

PrintError

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

Enum

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

"FAILED"
Indique qu'un échec général s'est produit.

"INVALID_TICKET"
Indique 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 ses paramètres.

"INVALID_DATA"
Indique que le document n'est pas valide. Par exemple, les données peuvent être corrompues ou le format est 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

    Élément 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 le ticket au format CJT.

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

  • title

    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 l'accès aux fonctionnalités de l'imprimante.

Paramètres

  • rappel

    function

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

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

    • printerId

      chaîne

    • resultCallback

      function

      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 les extensions.

Paramètres

  • rappel

    function

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

    (resultCallback: function)=>void

    • resultCallback

      function

      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 pouvant être une imprimante.

Remarque:Une application ne doit pas s'appuyer 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

    function

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

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

    • appareil

      usb.Device

    • resultCallback

      function

      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

  • rappel

    function

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

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

    • printJob

      PrintJob

    • resultCallback

      function

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

      (result: PrintError)=>void