tabs.onActivated
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. Renvoietrue
s'il écoute, sinonfalse
.
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.
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
Compatibilité des navigateurs
BCD tables only load in the browser
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.