tabs.onUpdated

Lancé lorsqu'un onglet est mis à jour

Syntaxe

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

tabId
integer. ID de l'onglet qui a été mis à jour.
changeInfo
object. Contient des propriétés pour les propriétés de l'onglet qui ont été modifiées. Voir changeInfo ci-dessous.
tab
tabs.Tab. Le nouvel état de l'onglet.

Objets supplémentaires

changeInfo

Répertorie les modifications apportées à l'état de l'onglet mis à jour. Pour en savoir plus sur ces propriétés, consultez la documentation tabs.Tab.

audibleFacultatif
boolean. Nouvel état audible de l'onglet.
discarded Facultatif
boolean. Si l'onglet est ignoré. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé.
favIconUrlFacultatif
string. Nouvelle URL de favicon de l'onglet.
mutedInfoFacultatif
tabs.MutedInfo. Le nouvel état muet de l'onglet et la raison du changement.
pinnedFacultatif
boolean. Nouvel état épinglé de l'onglet.
statusFacultatif
string. Le statut de l'onglet. Peut être soit chargé ou complet.
titleFacultatif
string. Le nouveau titre de l'onglet.
urlFacultatif
string. L'URL de l'onglet s'il a changé.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui144554 Oui
changeInfo.audible Oui144554 Oui
changeInfo.discarded Oui145757 Oui
changeInfo.favIconUrl Oui144554 Oui
changeInfo.mutedInfo Oui144554 Oui
changeInfo.pinned Oui144554 Oui
changeInfo.status Oui144554 Oui
changeInfo.title Oui145354 Oui
changeInfo.url Oui144554 Oui

Exemples

Écoutez et connectez toutes les informations de changement et nouvel état:

function handleUpdated(tabId, changeInfo, tabInfo) {
  console.log("Updated tab: " + tabId);
  console.log("Changed attributes: ");
  console.log(changeInfo);
  console.log("New tab Info: ");
  console.log(tabInfo);  
}

browser.tabs.onUpdated.addListener(handleUpdated);

Consigner les modifications dans les URL :

function handleUpdated(tabId, changeInfo, tabInfo) {
  if (changeInfo.url) {
    console.log("Tab: " + tabId +
                " URL changed to " + changeInfo.url);
  }
}

browser.tabs.onUpdated.addListener(handleUpdated);

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.

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,