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
tabId
Facultatif-
integer
. ID de l'onglet à capturer. Par défaut à l'onglet actif dans la fenêtre en cours. options
Facultatif
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.captureTab();
capturing.then(onCaptured, onError);
});
Compatibilité des navigateurs
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
captureTab |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
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.