browsingData.removeDownloads()

Efface l'historique de téléchargement du navigateur. Notez que cela ne supprime pas les objets téléchargés eux-mêmes, seulement les enregistrements de téléchargements dans l'historique du navigateur.

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

  • Efface les enregistrements des élements téléchargés après un temps donné
  • contrôle si vous souhaitez effacer uniquement les enregistrements d'éléments téléchargés à partir de pages Web normales ou pour supprimer également 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.removeDownloads(
  removalOptions, // RemovalOptions object
);

Paramètres

removalOptions

object. Un objet browsingData.RemovalOptions, qui peut-être utilisé pour effacer uniquement les enregistrements créés après une heure donnée, et pour effacer uniquement les enregistrements d'éléments téléchargés depuis les pages Web normales ou pour effacer des enregistrements d'applications hébergées et extensions aussi bien.

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

BCD tables only load in the browser

Exemples

Supprime les enregistrements d'objets téléchargés 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
  .removeDownloads({ since: oneWeekAgo })
  .then(onRemoved, onError);

Supprime tous les enregistrements d'objets téléchargés :

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

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

browser.browsingData.removeDownloads({}).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.