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

js
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

Exemples

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

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

browser.tabs.onHighlighted.addListener(handleHighlighted);

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
onHighlighted

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Has more compatibility info.

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.