--- title: tabs.captureVisibleTab() slug: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab tags: - API - Add-ons - Extensions - Méthode - Non-standard - Reference - WebExtensions - captureVisibleTab - tabs translation_of: Mozilla/Add-ons/WebExtensions/API/tabs/captureVisibleTab ---
{{AddonSidebar()}}

Crée une URI de données codant une image de la zone visible de l'onglet actuellement actif dans la fenêtre spécifiée. Vous devez avoir la  permission <all_urls> pour utiliser cette méthode. (Alternativement, Chrome permet l'utilisation de cette méthode avec la permission activeTab et un geste utilisateur qualifiant).

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var capturing = browser.tabs.captureVisibleTab(
  windowId,               // optional integer
  options                 // optional extensionTypes.ImageDetails
)

Paramètres

windowId{{optional_inline}}
integer. La fenêtre cible Par défaut à la fenêtre actuelle.
options{{optional_inline}}
{{WebExtAPIRef('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.

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.captureVisibleTab();
  capturing.then(onCaptured, onError);
});

{{WebExtExamples}}

Compatibilité du navigateur

{{Compat("webextensions.api.tabs.captureVisibleTab")}}

Note :

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.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.