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

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

BCD tables only load in the browser

Exemples

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

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

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

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

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

Note :

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.