history.onVisitRemoved
Lancé lorsqu'une page est complètement supprimée de l'historique du navigateur.
- Si toutes les visites d'une seule page sont supprimées (par exemple, en utilisant
history.deleteUrl
), cet événement est déclenché une fois. - Si une série de visites est supprimée (par exemple, en utilisant
history.deleteRange
ou une fonctionnalité de navigateur telle que "Effacer l'historique récent"), alors il est tiré une fois pour chaque page dont les visites tombent toutes dans la plage autorisée. - Si l'historique complet du navigateur est effacé (par exemple, en utilisant
history.deleteAll
), il est déclenché une seule fois.
Syntaxe
browser.history.onVisitRemoved.addListener(listener);
browser.history.onVisitRemoved.removeListener(listener);
browser.history.onVisitRemoved.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 sera passée l'argument suivant :
removed
-
object
. Détails de l'enlèvement. C'est un objet contenant deux propriétés: un booléenallHistory
et un tableauurls
.- Si cet événement se déclenche parce qu'il est clair,
allHistory
seratrue
eturls
sera un tableau vide. - Dans le cas contraire,
allHistory
serafalse
eturls
contiendront un qui est l'URL de la page supprimée.
- Si cet événement se déclenche parce qu'il est clair,
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
function onRemoved(removed) {
if (removed.allHistory) {
console.log("All history removed");
} else if (removed.urls.length) {
console.log("URL removed: " + removed.urls[0]);
}
}
browser.history.onVisitRemoved.addListener(onRemoved);
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.