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 --- .../webextensions/api/downloads/erase/index.md | 72 +++++++++++----------- 1 file changed, 35 insertions(+), 37 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/api/downloads/erase') diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md index 44d9d1fe46..65e1a1cd10 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md @@ -14,45 +14,43 @@ tags: - erase translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/erase --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

La fonction erase() de l'API {{WebExtAPIRef("downloads")}} efface la correspondance {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} de l'historique de téléchargement du navigateur sans supprimer les fichiers téléchargés du disque.

+La fonction **`erase`\*\***`()`\*\* de l'API {{WebExtAPIRef("downloads")}} efface la correspondance {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} de l'historique de téléchargement du navigateur sans supprimer les fichiers téléchargés du disque. -

Pour supprimer les fichiers du disque, vous devez utiliser {{WebExtAPIRef("downloads.removeFile()")}}.

+Pour supprimer les fichiers du disque, vous devez utiliser {{WebExtAPIRef("downloads.removeFile()")}}. -

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 {{WebExtAPIRef("downloads.removeFile()")}} before you call erase(). Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de {{WebExtAPIRef("downloads.removeFile()")}}, car il n'existe plus selon le navigateur.

-
+> **Note :** Si vous souhaitez supprimer un fichier téléchargé du disque et l'effacer de l'historique, vous devez appeler {{WebExtAPIRef("downloads.removeFile()")}} before you call `erase()`. Si vous l'essayez dans l'autre sens, vous obtiendrez une erreur lors de l'appel de {{WebExtAPIRef("downloads.removeFile()")}}, car il n'existe plus selon le navigateur. -

Syntaxe

+## Syntaxe -
var erasing = browser.downloads.erase(
+```js
+var erasing = browser.downloads.erase(
   query                    // DownloadQuery
 )
-
+``` -

Paramètres

+### Paramètres -
-
query
-
Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.
-
+- `query` + - : Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}. -

Valeur retournée

+### Valeur retournée -

Une Promise. Si l'appel a réussi, la promesse sera remplie avec un tableau d'entiers représentant les identifiants des {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} effacés. Si aucun élément correspondant au paramètre de requête n'a pu être trouvé, le tableau sera vide. Si l'appel a échoué, la promesse sera rejetée avec un message d'erreur.

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si l'appel a réussi, la promesse sera remplie avec un tableau d'entiers représentant les identifiants des {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} effacés. Si aucun élément correspondant au paramètre de requête n'a pu être trouvé, le tableau sera vide. Si l'appel a échoué, la promesse sera rejetée avec un message d'erreur. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

Effacer le téléchargement le plus récent :

+Effacer le téléchargement le plus récent : -
function onErased(ids) {
+```js
+function onErased(ids) {
   console.log(`Erased: ${ids}`);
 }
 
@@ -65,11 +63,13 @@ var erasing = browser.downloads.erase({
   orderBy: ["-startTime"]
 });
 
-erasing.then(onErased, onError);
+erasing.then(onErased, onError); +``` -

Tout effacer :

+Tout effacer : -
function onErased(ids) {
+```js
+function onErased(ids) {
   console.log(`Erased: ${ids}`);
 }
 
@@ -78,19 +78,18 @@ function onError(error) {
 }
 
 var erasing = browser.downloads.erase({});
-erasing.then(onErased, onError);
+erasing.then(onErased, 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