Modules

tabs.onHighlighted

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

Firefox n'a pas le concept de mettre en évidence plusieurs onglets, et donc, dans Firefox, la mise en évidence n'est qu'un alias pour l'activation d'un onglet. Cet événement se déclenchera donc uniquement lorsque l'onglet actif d'une fenêtre sera modifié, et la propriété tabIds de highlightInfo sera toujours un tableau de longueur un, avec le tabId se référant à l'onglet actif.

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

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui Non4554 Non

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.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

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