From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/downloads/removefile/index.html | 118 +++++++++++++++++++++ 1 file changed, 118 insertions(+) create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html (limited to 'files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html') diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html new file mode 100644 index 0000000000..54981387d4 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html @@ -0,0 +1,118 @@ +--- +title: downloads.removeFile() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/removeFile +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - removeFile +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/removeFile +--- +
{{AddonSidebar()}}
+ +

La fonction removeFile() de l'API {{WebExtAPIRef("downloads")}} supprime un fichier téléchargé du disque.

+ +

Cette API supprime le fichier du disque, mais ne le supprime pas de l'historique des téléchargements du navigateur, donc un appel  {{WebExtAPIRef("downloads.search()")}} renvoie toujours l'élément comme {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, mais son attribut exists sera false.

+ +

Pour supprimer un fichier de l'historique des téléchargements, vous devez utiliser  {{WebExtAPIRef("downloads.erase()")}}.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +
+

Remarque : Si vous souhaitez supprimer un fichier téléchargé du disque et l'effacer de l'historique, vous devez appeler removeFile() avant d'appeler {{WebExtAPIRef("downloads.erase()")}}. Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de removeFile(), car le navigateur n'aura plus d'enregistrement du téléchargement.

+
+ +

Syntaxe

+ +
var removing = browser.downloads.removeFile(
+  downloadId      // integer
+)
+
+ +

Paramètres

+ +
+
downloadId
+
Un integer représentant l'identifiant de  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} que vous souhaitez supprimer du disque.
+
+ +

Valeur retournée

+ +

Une Promise. Si la demande a été acceptée, la promesse sera remplie sans arguments. Si la demande a échoué, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ + + +

{{Compat("webextensions.api.downloads.removeFile")}}

+ +

Exemples

+ +

Supprimer le dernier fichier téléchargé :

+ +
function onRemoved() {
+  console.log(`Removed item`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function remove(downloadItems) {
+  if (downloadItems.length > 0) {
+    var removing = browser.downloads.removeFile(downloadItems[0].id);
+    removing.then(onRemoved, onError);
+  }
+}
+
+var searching = browser.downloads.search({
+  limit: 1,
+  orderBy: ["-startTime"]
+});
+
+searching.then(remove, onError);
+ +

{{WebExtExamples}}

+ +
Remerciements : + +

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

+ +

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.

+
+ + -- cgit v1.2.3-54-g00ecf