tabs.captureTab()

Crée un URI de données codant une image de la zone visible de l'onglet donné. Vous devez avoir la permission <all_urls> pour utiliser cette méthode.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var capturing = browser.tabs.captureTab(
  tabId,               // optional integer
  options              // optional extensionTypes.ImageDetails
)

Paramètres

tabIdFacultatif
integer. ID de l'onglet à capturer. Par défaut à l'onglet actif dans la fenêtre en cours.
optionsFacultatif
extensionTypes.ImageDetails.

Valeur retournée

Une Promise qui sera remplie avec une URL de données qui code une image de la zone visible de l'onglet capturé. Peut être affecté à la propriété 'src' d'un élément HTML Image pour l'affichage. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Aucun support NonEdge Aucun support NonFirefox Support complet 59Opera Aucun support NonFirefox Android Support complet 59

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Exemples

Capturez une image de l'onglet actif dans la fenêtre actuelle, avec les paramètres par défaut :

function onCaptured(imageUri) {
  console.log(imageUri);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener(function() {
  var capturing = browser.tabs.captureTab();
  capturing.then(onCaptured, onError);
});

Remerciements :

Cette API est basée sur l'API Chromium chrome.tabs. Cette documentation est dérivée de tabs.json dans le code de Chromium code.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : wbamberg, hellosct1
Dernière mise à jour par : wbamberg,