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 peut ne seront chargées que dans le frame principal.

Autorisations

pageCapture

Vous devez déclarer la valeur "pageCapture" autorisation d'utiliser la fonction pageCapture dans le fichier manifeste de l'extension API. Exemple :

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

Méthodes

saveAsMHTML()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
)

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

Paramètres

  • détails

    objet

    • tabId

      Nombre

      Identifiant de l'onglet à enregistrer au format MHTML.

  • rappel

    function facultatif

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

    (mhtmlData?: ArrayBuffer) => void

    • mhtmlData

      ArrayBuffer facultatif

      Données MHTML sous forme d'objet Blob.

Renvoie

  • Promise&lt;ArrayBuffer | indéfini>

    Chrome 116 et versions ultérieures

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