browsingData.removeHistory()

Efface l'enregistrement des pages Web que l'utilisateur a visité (historique de navigation).

Vous pouvez utiliser le paramètre removalOptions, qui est un objet  browsingData.RemovalOptions pour :

  • Effacer uniquement les eenregistrements des pages Web visitées après un certain temps.
  • Contrôlez si vous souhaitez effacer uniquement les enregistrements des pages web normales ou effacer les enregistrements des applications hébergées et des extensions.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var removing = browser.browsingData.removeHistory(
  removalOptions            // RemovalOptions object
)

Paramètres

removalOptions
object. Un objet browsingData.RemovalOptions, qui peut-être utilisé pour effacer uniquement les enregistrements des pages Web visitées après un certain temp, et pour effacer uniquement les enregistrements des pages Web normales ou pour effacer les enregistrements des applications hébergées et extensions aussi bien.

Valeur retournée

Une Promise sera rempli sans arguments lorsque la suppression est terminée. Si une erreur se produit, la promise sera rejetée avec un message d'erreur.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes This function also removes download history and service workers.
Opera Support complet OuiFirefox Android Aucun support Non
Notes
Aucun support Non
Notes
Notes See bug 1363010. browser.history.remove(options, {history:true}) can be used instead.

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Exemples

Supprimer les enregistrements de la page visitées de la semaine dernière :

function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 * 60 * 60 * 24 * 7;
}

var oneWeekAgo = (new Date()).getTime() - weekInMilliseconds();

browser.browsingData.removeHistory(
  {since: oneWeekAgo}).
then(onRemoved, onError);

Supprimer tous les enregistrements des pages visitées :

function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeHistory({}).
then(onRemoved, onError);

Remerciements :

Cette API est basée sur l'API Chromium chrome.browsingData.

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,