Masque un ou plusieurs onglets.
Les onglets cachés ne sont plus visibles dans l'onglet du navigateur. Les onglets cachés ne sont pas automatiquement supprimés : le code qui s'y trouve continue à s'exécuter. Vous pouvez explicitement supprimer les onglets à chaque fois que vous les masquez : bien que cela ne soit pas approprié dans toutes les situations, cela aidera à réduire les ressources utilisées par le navigateur.
C'est une fonction asynchrone qui renvoie une Promise
.
Tous les onglets ne peuvent pas être masqués :
- Les onglets épinglés ne peuvent pas être masqués.
- Les onglets qui partagent l'écran, le microphone ou l'appareil photo ne peuvent pas être masqués.
- L'onglet actif actuel ne peut pas être masqué.
- Les onglets en cours de fermeture ne peuvent pas être masqués.
La première fois qu'une extension cache un onglet, le navigateur indiquera à l'utilisateur que l'onglet est caché, leur montrera comment ils peuvent accéder à l'onglet caché et leur donnera l'option de désactiver l'extension à la place.
Pour utiliser cette API, vous devez disposer de la permission "tabHide".
Syntaxe
var hiding = browser.tabs.hide( tabIds // integer or integer array )
Paramètres
tabIds
orinteger
ofarray
. Les ID de l'onglet ou des onglets à masquer.integer
- Si l'un de ces onglets ne peut pas être masqué, il ne sera pas masqué, mais l'appel sera toujours valide et les onglets éligibles seront toujours masqués. Par exemple, si vous passez
[1, 3]
, et1
identifie l'onglet actif, alors seulement3
seront cachés. - Cependant, si l'un des ID d'onglet n'est pas valide, l'appel échouera et aucun onglet ne sera masqué.
Valeur retournée
Une Promise
qui sera remplie avec un tableau contenant les ID des onglets qui ont été cachés. Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.
Compatibilité du navigateur
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Ordinateur | Mobile | ||||
---|---|---|---|---|---|
Support simple | Chrome Aucun support Non | Edge Aucun support Non | Firefox
Support complet
61
| Opera Aucun support Non | Firefox Android Aucun support Non |
Légende
- Support complet
- Support complet
- Aucun support
- Aucun support
- Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
- Fonctionnalité expérimentale. Celle-ci peut être amenée à changer par la suite.
- Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
- Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
- Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
- Une action explicite de l'utilisateur est nécessaire pour activer cette fonctionnalité.
Exemples
Masquer un seul onglet :
function onHidden() { console.log(`Hidden`); } function onError(error) { console.log(`Error: ${error}`); } browser.tabs.hide(2).then(onHidden, onError);
Masquer plusieurs onglets :
function onHidden() { console.log(`Hidden`); } function onError(error) { console.log(`Error: ${error}`); } browser.tabs.hide([15, 14, 1]).then(onHidden, onError);