tabs.hide()

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
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.

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

Compatibilité du navigateur

BCD tables only load in the browser