--- title: browsingData.remove() slug: Mozilla/Add-ons/WebExtensions/API/browsingData/remove tags: - API - Add-ons - Extensions - Method - Reference - WebExtensions - browsingData - remove - supprimer translation_of: Mozilla/Add-ons/WebExtensions/API/browsingData/remove ---
{{AddonSidebar()}}

Supprime les données de navigation spécifiées.

Les données de navigation à supprimer sont spécifiées dans l'option  dataTypes, qui est un objet  {{WebExtAPIRef("browsingData.DataTypeSet")}}.

Vous pouvez utiliser l'option removalOptions, qui est un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, pour contrôler à quelle distance remonter dans le temps pour supprimer des données et supprimer les données uniquement à partir de pages Web normales ou pour supprimer des données hébergées d'applications et extensions aussi.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var removing = browser.browsingData.remove(
  removalOptions,            // RemovalOptions object
  dataTypes                  // DataTypeSet object
)

Paramètres

removalOptions
object. Un objet {{WebExtAPIRef("browsingData.RemovalOptions")}}, qui peut être utilisé pour contrôler à quelle distance remonter dans le temps pour supprimer des données, et si vous souhaitez supprimer des données des applications Web hébergées et des extensions ou simplement des pages Web normales.
dataTypes
object. Un objet {{WebExtAPIRef("browsingData.DataTypeSet")}}, décrit les types de données à supprimer (par exemple, historique, les téléchargements,...).

Valeur retournée

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

Compatibilité du navigateur

{{Compat("webextensions.api.browsingData.remove")}}

Exemples

Supprimer l'historique des téléchargements et de l'histoire de navigation 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.remove(
  {since: oneWeekAgo},
  {downloads: true, history: true}).
then(onRemoved, onError);

Supprimer tout l'historique de téléchargement et de navigation :

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

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

browser.browsingData.remove({},
  {downloads: true, history: true}).
then(onRemoved, onError);

{{WebExtExamples}}

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.