From f36cc6a7639a8f1adff02bc7a152bd7f54ceae6d Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:09 +0100 Subject: move *.html to *.md --- .../api/downloads/removefile/index.html | 116 --------------------- 1 file changed, 116 deletions(-) delete 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 deleted file mode 100644 index 4bc3a2a440..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html +++ /dev/null @@ -1,116 +0,0 @@ ---- -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.

- -
-

Note : 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}}

- -

Note :

- -

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