Se déclenche lorsque l'onglet actif dans une fenêtre change. Notez que l'URL de l'onglet peut ne pas être définie au moment où cet événement s'est déclenché, mais vous pouvez écouter les événements tabs.onUpdated pour être averti lorsqu'une URL est définie.

Syntaxe

browser.tabs.onActivated.addListener(listener)
browser.tabs.onActivated.removeListener(listener)
browser.tabs.onActivated.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 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 :

activeInfo
object. ID de l'onglet qui a été activé, et ID de sa fenêtre.

Objets supplémentaires

activeInfo

previousTabId
integer. L'ID de l'onglet activé précédent, si cet onglet est encore ouvert.
tabId
integer. L'ID de l'onglet qui est devenu actif.
windowId
integer. L'ID de la fenêtre de l'onglet.

Compatibilité du navigateur

 

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Support complet 14Firefox Support complet 45Opera Support complet OuiFirefox Android Support complet 54

Légende

Support complet  
Support complet

 

Exemples

Écouter et enregistrer les événements d'activation des onglets :

function handleActivated(activeInfo) {
  console.log("Tab " + activeInfo.tabId +
              " was activated");
}

browser.tabs.onActivated.addListener(handleActivated);

Example extensions

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, wbamberg
Dernière mise à jour par : hellosct1,