From 3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93 Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:15 +0100 Subject: convert content to md --- .../api/downloads/removefile/index.md | 68 ++++++++++------------ 1 file changed, 32 insertions(+), 36 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/api/downloads/removefile') diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md index 4bc3a2a440..877b2e17e7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md @@ -13,47 +13,45 @@ tags: - removeFile translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/removeFile --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

+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.

+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()")}}.

+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.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/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.

-
+> **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

+## Syntaxe -
var removing = browser.downloads.removeFile(
+```js
+var removing = browser.downloads.removeFile(
   downloadId      // integer
 )
-
+``` -

Paramètres

+### Paramètres -
-
downloadId
-
Un integer représentant l'identifiant de  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} que vous souhaitez supprimer du disque.
-
+- `downloadId` + - : Un `integer` représentant l'identifiant de  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} que vous souhaitez supprimer du disque. -

Valeur retournée

+### 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.

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/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

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

Supprimer le dernier fichier téléchargé :

+Supprimer le dernier fichier téléchargé : -
function onRemoved() {
+```js
+function onRemoved() {
   console.log(`Removed item`);
 }
 
@@ -62,7 +60,7 @@ function onError(error) {
 }
 
 function remove(downloadItems) {
-  if (downloadItems.length > 0) {
+  if (downloadItems.length > 0) {
     var removing = browser.downloads.removeFile(downloadItems[0].id);
     removing.then(onRemoved, onError);
   }
@@ -73,19 +71,18 @@ var searching = browser.downloads.search({
   orderBy: ["-startTime"]
 });
 
-searching.then(remove, onError);
+searching.then(remove, onError); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/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. -

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