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

js
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é des navigateurs

BCD tables only load in the browser

Exemples

js
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.