tabs.onHighlighted

Lancé lorsque l'ensemble des onglets en surbrillance dans une fenêtre change

Notez qu'avant la version 63, Firefox n'avait pas le concept de mettre en évidence plusieurs onglets, donc cet événement n'était qu'un alias pour tabs.onActivated.

Syntaxe

browser.tabs.onHighlighted.addListener(listener)
browser.tabs.onHighlighted.removeListener(listener)
browser.tabs.onHighlighted.hasListener(listener)

Les événements ont trois fonctions :

addListener(callback)
Ajoute un écouteur à cet événement.
removeListener(listener)
Arrêtez d'écouter cet événement. L'argument listener de l'écouteur est l'écouteur à supprimer.
hasListener(listener)
Vérifiez si listener est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.

Syntaxe addListener

Paramètres

callback

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

highlightInfo
object. ID(s) des onglets en surbrillance, et ID de leur fenêtre.

Objets supplémentaires

highlightInfo

windowId
integer. ID de la fenêtre dont les onglets ont changé.
tabIds
array d'integer. Identifiants des onglets en surbrillance dans la fenêtre

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 63
Support complet 63
Aucun support 45 — 62
Notes
Notes Implemented as an alias for onActivated.
Opera Aucun support NonFirefox Android Support complet 54
Notes
Support complet 54
Notes
Notes Implemented as an alias for onActivated.

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Exemples

Ecoutez les événements en surbrillance et consignez les ID des onglets mis en surbrillance

function handleHighlighted(highlightInfo) {
  console.log("Highlighted tabs: " + highlightInfo.tabIds);
}

browser.tabs.onHighlighted.addListener(handleHighlighted);

Remerciements :

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.

Étiquettes et contributeurs liés au document

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