Notez qu'il s'agit actuellement d'une API expérimentale: elle peut être modifiée ou supprimée à tout moment.

Il est uniquement pris en charge dans Firefox et est désactivé par défaut. Pour l'activer, rendez-vous sur: config et réglez "extensions.webextensions.tabhide.enabled" sur true.

Masque un ou plusieurs onglets.

Les onglets masqués ne sont plus visibles dans la barre d'onglets du navigateur. Les onglets masqués ne sont pas automatiquement ignorés : le code qui les exécute continue de s'exécuter. Toutefois, il est recommandé de supprimer également les onglets masqués afin de gérer la mémoire et l'utilisation des ressources..

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.

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
integer or array of integer. Les ID de l'onglet ou des onglets à masquer.
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], et 1 identifie l'onglet actif, alors seulement 3 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

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Non Non591 Non Non

1. From version 59: this feature is behind the extensions.webextensions.tabhide.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

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);

Étiquettes et contributeurs liés au document

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