chrome.pageCapture

Description

Utilisez l'API chrome.pageCapture pour enregistrer un onglet au format MHTML.

MHTML est un format standard compatible avec la plupart des navigateurs. Il encapsule dans un seul fichier une page et toutes ses ressources (fichiers CSS, images, etc.).

Notez que, pour des raisons de sécurité, un fichier MHTML ne peut être chargé qu'à partir du système de fichiers et qu'il ne peut être chargé que dans le frame principal.

Autorisations

pageCapture

Pour utiliser l'API pageCapture, vous devez déclarer l'autorisation "pageCapture" dans le fichier manifeste de l'extension. Exemple :

{
  "name": "My extension",
  ...
  "permissions": [
    "pageCapture"
  ],
  ...
}

Méthodes

saveAsMHTML()

Promesse 
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
)

Enregistre le contenu de l'onglet avec l'ID donné en tant que MHTML.

Paramètres

  • détails

    objet

    • tabId

      number

      ID de l'onglet à enregistrer au format MHTML.

  • rappel

    fonction facultative

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

    (mhtmlData?: ArrayBuffer)=>void

    • mhtmlData

      ArrayBuffer facultatif

      Données MHTML en tant qu'objet blob.

Renvoie

  • Promise<ArrayBuffer|undefined>

    Chrome 116 et versions ultérieures

    Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.