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. 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 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éen allHistory et un tableau urls.
  • Si cet événement se déclenche parce qu'il est clair, allHistory sera true et urls sera un tableau vide.
  • Dans le cas contraire,  allHistory sera false et urls contiendront un qui est l'URL de la page supprimée.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 50Opera Support complet OuiFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support

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);

Remerciements :

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,