history.onVisited
Mise en place à chaque fois que l'utilisateur visite une page. Un objet history.HistoryItem
est transmis à l'écouteur. Cet événement se déclenche avant que la page ne soit chargée.
Syntaxe
browser.history.onVisited.addListener(listener);
browser.history.onVisited.removeListener(listener);
browser.history.onVisited.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érifie 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 :
result
-
history.HistoryItem
. Un objet représentant l'élément dans l'historique du navigateur.Au moment où cet événement est envoyé, le navigateur ne connaît pas encore le titre de la page. Si le navigateur a déjà visité cette page et s'est souvenu de son ancien titre, l'objet
HistoryItem.title
contiendra l'ancien titre de la page. Si le navigateur n'a pas d'enregistrement de l'ancien titre de la page, alorsHistoryItem.title
sera vide. Pour obtenir les titres des pages dès qu'ils sont connus, écoutezhistory.onTitleChanged
.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
Écoutez les visites et consignez l'URL et l'heure de visite.
function onVisited(historyItem) {
console.log(historyItem.url);
console.log(new Date(historyItem.lastVisitTime));
}
browser.history.onVisited.addListener(onVisited);
Note :
Cette API est basée sur l'API Chromium chrome.history
. Cette documentation est dérivée de history.json
dans le code de Chromium.
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.