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/acceptdanger/index.html | 84 ----------- .../api/downloads/acceptdanger/index.md | 84 +++++++++++ .../api/downloads/booleandelta/index.html | 72 --------- .../api/downloads/booleandelta/index.md | 72 +++++++++ .../webextensions/api/downloads/cancel/index.html | 99 ------------ .../webextensions/api/downloads/cancel/index.md | 99 ++++++++++++ .../api/downloads/dangertype/index.html | 91 ----------- .../api/downloads/dangertype/index.md | 91 +++++++++++ .../api/downloads/doubledelta/index.html | 73 --------- .../api/downloads/doubledelta/index.md | 73 +++++++++ .../api/downloads/download/index.html | 142 ------------------ .../webextensions/api/downloads/download/index.md | 142 ++++++++++++++++++ .../api/downloads/downloaditem/index.html | 109 -------------- .../api/downloads/downloaditem/index.md | 109 ++++++++++++++ .../api/downloads/downloadquery/index.html | 120 --------------- .../api/downloads/downloadquery/index.md | 120 +++++++++++++++ .../api/downloads/downloadtime/index.html | 77 ---------- .../api/downloads/downloadtime/index.md | 77 ++++++++++ .../webextensions/api/downloads/drag/index.html | 78 ---------- .../webextensions/api/downloads/drag/index.md | 78 ++++++++++ .../webextensions/api/downloads/erase/index.html | 121 --------------- .../webextensions/api/downloads/erase/index.md | 121 +++++++++++++++ .../downloads/filenameconflictaction/index.html | 77 ---------- .../api/downloads/filenameconflictaction/index.md | 77 ++++++++++ .../api/downloads/getfileicon/index.html | 121 --------------- .../api/downloads/getfileicon/index.md | 121 +++++++++++++++ .../add-ons/webextensions/api/downloads/index.html | 132 ---------------- .../add-ons/webextensions/api/downloads/index.md | 132 ++++++++++++++++ .../api/downloads/interruptreason/index.html | 117 --------------- .../api/downloads/interruptreason/index.md | 117 +++++++++++++++ .../api/downloads/onchanged/index.html | 148 ------------------ .../webextensions/api/downloads/onchanged/index.md | 148 ++++++++++++++++++ .../api/downloads/oncreated/index.html | 108 -------------- .../webextensions/api/downloads/oncreated/index.md | 108 ++++++++++++++ .../api/downloads/onerased/index.html | 113 -------------- .../webextensions/api/downloads/onerased/index.md | 113 ++++++++++++++ .../webextensions/api/downloads/open/index.html | 110 -------------- .../webextensions/api/downloads/open/index.md | 110 ++++++++++++++ .../webextensions/api/downloads/pause/index.html | 94 ------------ .../webextensions/api/downloads/pause/index.md | 94 ++++++++++++ .../api/downloads/removefile/index.html | 116 -------------- .../api/downloads/removefile/index.md | 116 ++++++++++++++ .../webextensions/api/downloads/resume/index.html | 97 ------------ .../webextensions/api/downloads/resume/index.md | 97 ++++++++++++ .../webextensions/api/downloads/search/index.html | 166 --------------------- .../webextensions/api/downloads/search/index.md | 166 +++++++++++++++++++++ .../api/downloads/setshelfenabled/index.html | 82 ---------- .../api/downloads/setshelfenabled/index.md | 82 ++++++++++ .../webextensions/api/downloads/show/index.html | 109 -------------- .../webextensions/api/downloads/show/index.md | 109 ++++++++++++++ .../api/downloads/showdefaultfolder/index.html | 81 ---------- .../api/downloads/showdefaultfolder/index.md | 81 ++++++++++ .../webextensions/api/downloads/state/index.html | 81 ---------- .../webextensions/api/downloads/state/index.md | 81 ++++++++++ .../api/downloads/stringdelta/index.html | 73 --------- .../api/downloads/stringdelta/index.md | 73 +++++++++ 56 files changed, 2891 insertions(+), 2891 deletions(-) delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md delete mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.html create mode 100644 files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md (limited to 'files/fr/mozilla/add-ons/webextensions/api/downloads') diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.html deleted file mode 100644 index fe7a263f39..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: downloads.acceptDanger() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - acceptDanger - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger ---- -
{{AddonSidebar()}}
- -

La fonction acceptDanger() de l'API {{WebExtAPIRef("downloads")}} invite l'utilisateur à accepter ou à annuler un téléchargement potentiellement dangereux.

- -

Cette fonction ne peut pas être appelée à partir de scripts d'arrière-plan, uniquement dans les scripts qui s'exécutent dans une fenêtre visible (par exemple un navigateur ou une fenêtre d'action de page).

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var prompting = browser.downloads.acceptDanger(
-  downloadId      // integer
-)
-
- -

Parameters

- -
-
downloadId
-
Un integer représentant l'id de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} en question.
-
- -

Valeur retournée

- -

Une Promise. Lorsque la boîte de dialogue se ferme, la promesse sera remplie sans arguments.

- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md new file mode 100644 index 0000000000..fe7a263f39 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md @@ -0,0 +1,84 @@ +--- +title: downloads.acceptDanger() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - acceptDanger + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger +--- +
{{AddonSidebar()}}
+ +

La fonction acceptDanger() de l'API {{WebExtAPIRef("downloads")}} invite l'utilisateur à accepter ou à annuler un téléchargement potentiellement dangereux.

+ +

Cette fonction ne peut pas être appelée à partir de scripts d'arrière-plan, uniquement dans les scripts qui s'exécutent dans une fenêtre visible (par exemple un navigateur ou une fenêtre d'action de page).

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var prompting = browser.downloads.acceptDanger(
+  downloadId      // integer
+)
+
+ +

Parameters

+ +
+
downloadId
+
Un integer représentant l'id de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} en question.
+
+ +

Valeur retournée

+ +

Une Promise. Lorsque la boîte de dialogue se ferme, la promesse sera remplie sans arguments.

+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.html deleted file mode 100644 index 43edabfce3..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: downloads.BooleanDelta -slug: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta -tags: - - API - - Add-ons - - BooleanDelta - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta ---- -
{{AddonSidebar()}}
- -

Le type BooleanDelta de l'API {{WebExtAPIRef("downloads")}} représente la différence entre deux booléens.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
current{{optional_inline}}
-
Un boolean représentant la valeur booléenne actuelle.
-
previous{{optional_inline}}
-
Un boolean représentant la valeur booléenne précédente.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md new file mode 100644 index 0000000000..43edabfce3 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md @@ -0,0 +1,72 @@ +--- +title: downloads.BooleanDelta +slug: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta +tags: + - API + - Add-ons + - BooleanDelta + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta +--- +
{{AddonSidebar()}}
+ +

Le type BooleanDelta de l'API {{WebExtAPIRef("downloads")}} représente la différence entre deux booléens.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
current{{optional_inline}}
+
Un boolean représentant la valeur booléenne actuelle.
+
previous{{optional_inline}}
+
Un boolean représentant la valeur booléenne précédente.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.html deleted file mode 100644 index 5a2bb1d7e9..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.html +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: downloads.cancel() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/cancel -tags: - - API - - Add-ons - - Annuler - - Extensions - - Metho - - Non-standard - - Reference - - Téléchargement - - WebExtensions - - cancel - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/cancel ---- -
{{AddonSidebar()}}
- -

La fonction cancel() de l'API de {{WebExtAPIRef("downloads")}} annule un téléchargement. L'appel échouera si le téléchargement n'est pas actif : par exemple, parce qu'il a terminé le téléchargement..

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var canceling = browser.downloads.cancel(
-  downloadId      // integer
-)
-
- -

Paramètres

- -
-
downloadId
-
integer. L'identifiant du téléchargement à annuler.
-
- -

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

- -

Exemples

- -
var downloadId = 13;
-
-function onCanceled() {
-  console.log(`Canceled download`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var canceling = browser.downloads.cancel(downloadId);
-canceling.then(onCanceled, 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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md new file mode 100644 index 0000000000..5a2bb1d7e9 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md @@ -0,0 +1,99 @@ +--- +title: downloads.cancel() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/cancel +tags: + - API + - Add-ons + - Annuler + - Extensions + - Metho + - Non-standard + - Reference + - Téléchargement + - WebExtensions + - cancel + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/cancel +--- +
{{AddonSidebar()}}
+ +

La fonction cancel() de l'API de {{WebExtAPIRef("downloads")}} annule un téléchargement. L'appel échouera si le téléchargement n'est pas actif : par exemple, parce qu'il a terminé le téléchargement..

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var canceling = browser.downloads.cancel(
+  downloadId      // integer
+)
+
+ +

Paramètres

+ +
+
downloadId
+
integer. L'identifiant du téléchargement à annuler.
+
+ +

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

+ +

Exemples

+ +
var downloadId = 13;
+
+function onCanceled() {
+  console.log(`Canceled download`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var canceling = browser.downloads.cancel(downloadId);
+canceling.then(onCanceled, 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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.html deleted file mode 100644 index 7f96700ba8..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: downloads.DangerType -slug: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType -tags: - - API - - Add-ons - - DangerType - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType ---- -

{{AddonSidebar()}}

- -

Le type DangerType de l'API {{WebExtAPIRef("downloads")}} définit un ensemble de raisons possibles pour lesquelles un fichier téléchargeable peut être considéré comme dangereux..

- -

Une propriété de danger {{WebExtAPIRef('downloads.DownloadItem')}} contiendra une chaîne tirée des valeurs définies dans ce type.

- -
-

Note : Ces constantes de chaîne ne changeront jamais, mais l'ensemble de DangerTypes peut changer.

-
- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

- -
-
file
-
Le nom de fichier du téléchargement est suspect.
-
url
-
L'URL du téléchargement est connue pour être malveillante.
-
content
-
Le fichier téléchargé est connu pour être malveillant.
-
uncommon
-
L'URL du téléchargement n'est pas généralement téléchargée.
-
host
-
Le téléchargement provenait d'un hôte connu pour distribuer des binaires malveillants.
-
unwanted
-
Le téléchargement est potentiellement indésirable ou dangereux..
-
safe
-
Le téléchargement ne présente aucun danger connu pour l'ordinateur de l'utilisateur.
-
accepted
-
L'utilisateur a accepté le téléchargement dangereux.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md new file mode 100644 index 0000000000..7f96700ba8 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md @@ -0,0 +1,91 @@ +--- +title: downloads.DangerType +slug: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType +tags: + - API + - Add-ons + - DangerType + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType +--- +

{{AddonSidebar()}}

+ +

Le type DangerType de l'API {{WebExtAPIRef("downloads")}} définit un ensemble de raisons possibles pour lesquelles un fichier téléchargeable peut être considéré comme dangereux..

+ +

Une propriété de danger {{WebExtAPIRef('downloads.DownloadItem')}} contiendra une chaîne tirée des valeurs définies dans ce type.

+ +
+

Note : Ces constantes de chaîne ne changeront jamais, mais l'ensemble de DangerTypes peut changer.

+
+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

+ +
+
file
+
Le nom de fichier du téléchargement est suspect.
+
url
+
L'URL du téléchargement est connue pour être malveillante.
+
content
+
Le fichier téléchargé est connu pour être malveillant.
+
uncommon
+
L'URL du téléchargement n'est pas généralement téléchargée.
+
host
+
Le téléchargement provenait d'un hôte connu pour distribuer des binaires malveillants.
+
unwanted
+
Le téléchargement est potentiellement indésirable ou dangereux..
+
safe
+
Le téléchargement ne présente aucun danger connu pour l'ordinateur de l'utilisateur.
+
accepted
+
L'utilisateur a accepté le téléchargement dangereux.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.html deleted file mode 100644 index 6dde623ac5..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: downloads.DoubleDelta -slug: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta -tags: - - API - - Add-ons - - DoubleDelta - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta ---- -
{{AddonSidebar()}}
- -

Le type DoubleDelta de l'API {{WebExtAPIRef("downloads")}} représente la différence entre deux doubles.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
current{{optional_inline}}
-
Un number représentant la double valeur actuelle.
-
previous{{optional_inline}}
-
Un number représentant la valeur double précédente.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md new file mode 100644 index 0000000000..6dde623ac5 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md @@ -0,0 +1,73 @@ +--- +title: downloads.DoubleDelta +slug: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta +tags: + - API + - Add-ons + - DoubleDelta + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta +--- +
{{AddonSidebar()}}
+ +

Le type DoubleDelta de l'API {{WebExtAPIRef("downloads")}} représente la différence entre deux doubles.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
current{{optional_inline}}
+
Un number représentant la double valeur actuelle.
+
previous{{optional_inline}}
+
Un number représentant la valeur double précédente.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.html deleted file mode 100644 index ff6364769b..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: downloads.download() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/download -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - download - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download ---- -
{{AddonSidebar()}}
- -

La fonction download() de l'API {{WebExtAPIRef("downloads")}} télécharge le fichier, compte tenu de son URL et d'autres préférences optionnelles.

- - - -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var downloading = browser.downloads.download(
-  options                   // object
-)
-
- -

Paramètres

- -
-
options
-

Un object spécifiant le fichier que vous souhaitez télécharger et toutes les autres préférences que vous souhaitez définir concernant le téléchargement. Il peut contenir les propriétés suivantes :

-
-
allowHttpErrors{{optional_inline}}
-

Un tag booléen qui permet de poursuivre les téléchargements même s'ils rencontrent des erreurs HTTP. L'utilisation de ce drapeau, par exemple, permet le téléchargement des pages d'erreur du serveur. La valeur par défaut est false. Lorsqu'il est défini à :

-
    -
  • false, le téléchargement est annulé lorsqu'il rencontre une erreur HTTP.
    • -
  • true, le téléchargement se poursuit lorsqu'une erreur HTTP est rencontrée et que l'erreur du serveur HTTP n'est pas signalée. Toutefois, si le téléchargement échoue en raison d'une erreur liée au fichier, au réseau, à l'utilisateur ou autre, cette erreur est signalée.
    • -
-
-
body{{optional_inline}}
-
Un string représentant le corps du message de la requête.
-
conflictAction{{optional_inline}}
-
Une chaîne représentant l'action que vous voulez effectuer s'il y a un conflit de nom de fichier, tel que défini dans le  {{WebExtAPIRef('downloads.FilenameConflictAction')}} type (par défaut "uniquify" quand il n'est pas spécifié).
-
filename{{optional_inline}}
-
Un string eprésentant un chemin d'accès au fichier par rapport au répertoire de téléchargement par défaut,  qui indique l'emplacement où vous souhaitez enregistrer le fichier et le nom de fichier que vous souhaitez utiliser. Les chemins absolus, les chemins vides et les chemins contenant des références arrières  (../) provoqueront une erreur. Si elle est omise, cette valeur sera par défaut le nom de fichier déjà donné au fichier de téléchargement, et un emplacement immédiatement dans le répertoire de téléchargement.
-
headers{{optional_inline}}
-
Si l'URL utilise les protocoles HTTP ou HTTPS, un array d'objects représentant des en-têtes HTTP supplémentaires à envoyer avec la requête. Chaque en-tête est représenté sous la forme d'un objet dictionnaire contenant le name des clés et soit la value, soit la valeur binaryValue. Les en-têtes interdits par XMLHttpRequest et fetch ne peuvent pas être spécifiés, cependant, Firefox 70 et les versions ultérieures permettent d'utiliser l'en-tête Referer. Tenter d'utiliser un en-tête interdit provoque une erreur.
-
incognito{{optional_inline}}
-
Un boolean: s'il est présent et défini sur true, associez ce téléchargement à une session de navigation privée. Cela signifie qu'il n'apparaîtra dans le gestionnaire de téléchargement que pour les fenêtres privées actuellement ouvertes.
-
method{{optional_inline}}
-
Un string représentant la méthode HTTP à utiliser si l'url utilise le protocole HTTP[S]. Cela peut être "GET" ou "POST".
-
saveAs{{optional_inline}}
-
-

Un boolean qui spécifie s'il faut fournir une boîte de dialogue de sélection de fichier pour permettre à l'utilisateur de sélectionner un nom de fichier (true), ou non (false).

- -

Si cette option est omise, le navigateur affichera le sélecteur de fichier ou non en fonction de la préférence générale de l'utilisateur pour ce comportement (dans Firefox cette préférence est intitulée "Toujours vous demander où enregistrer les fichiers" dans about:preferences, ou browser.download.useDownloadDir dans about:config).

- -
-

Note : Firefox pour Android provoque une erreur si saveAs est à  true. Le paramètre est ignoré lorsque saveAs est false ou non inclus.

-
-
-
url
-
Un string représentant l'URL à télécharger.
-
-
-
- -

Valeur retournée

- -

Une Promise. Si le téléchargement a démarré avec succès, la promesse sera remplie avec l'id de la nouvelle {{WebExtAPIRef("downloads.DownloadItem")}}. Sinon, la promesse sera rejetée avec un message d'erreur venant de  {{WebExtAPIRef("downloads.InterruptReason")}}.

- -

Si vous utilisez URL.createObjectURL() pour télécharger des données créées en JavaScript et que vous voulez révoquer l'URL de l'objet (avec revokeObjectURL) plus tard (comme il est fortement recommandé), vous devez le faire après le téléchargement. Pour ce faire, écoutez l'événement downloads.onChanged.

- -

Compatibilité du navigateur

- -

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

- -

Examples

- -

Le fragment suivant tente de télécharger un exemple de fichier, en spécifiant également un nom de fichier et un emplacement pour l'enregistrer, ainsi que l'option uniquify conflictAction.

- -
function onStartedDownload(id) {
-  console.log(`Started downloading: ${id}`);
-}
-
-function onFailed(error) {
-  console.log(`Download failed: ${error}`);
-}
-
-var downloadUrl = "https://example.org/image.png";
-
-var downloading = browser.downloads.download({
-  url : downloadUrl,
-  filename : 'my-image-again.png',
-  conflictAction : 'uniquify'
-});
-
-downloading.then(onStartedDownload, onFailed);
- -

{{WebExtExamples}}

- -

Note :

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md new file mode 100644 index 0000000000..ff6364769b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md @@ -0,0 +1,142 @@ +--- +title: downloads.download() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/download +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - download + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download +--- +
{{AddonSidebar()}}
+ +

La fonction download() de l'API {{WebExtAPIRef("downloads")}} télécharge le fichier, compte tenu de son URL et d'autres préférences optionnelles.

+ + + +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var downloading = browser.downloads.download(
+  options                   // object
+)
+
+ +

Paramètres

+ +
+
options
+

Un object spécifiant le fichier que vous souhaitez télécharger et toutes les autres préférences que vous souhaitez définir concernant le téléchargement. Il peut contenir les propriétés suivantes :

+
+
allowHttpErrors{{optional_inline}}
+

Un tag booléen qui permet de poursuivre les téléchargements même s'ils rencontrent des erreurs HTTP. L'utilisation de ce drapeau, par exemple, permet le téléchargement des pages d'erreur du serveur. La valeur par défaut est false. Lorsqu'il est défini à :

+
    +
  • false, le téléchargement est annulé lorsqu'il rencontre une erreur HTTP.
    • +
  • true, le téléchargement se poursuit lorsqu'une erreur HTTP est rencontrée et que l'erreur du serveur HTTP n'est pas signalée. Toutefois, si le téléchargement échoue en raison d'une erreur liée au fichier, au réseau, à l'utilisateur ou autre, cette erreur est signalée.
    • +
+
+
body{{optional_inline}}
+
Un string représentant le corps du message de la requête.
+
conflictAction{{optional_inline}}
+
Une chaîne représentant l'action que vous voulez effectuer s'il y a un conflit de nom de fichier, tel que défini dans le  {{WebExtAPIRef('downloads.FilenameConflictAction')}} type (par défaut "uniquify" quand il n'est pas spécifié).
+
filename{{optional_inline}}
+
Un string eprésentant un chemin d'accès au fichier par rapport au répertoire de téléchargement par défaut,  qui indique l'emplacement où vous souhaitez enregistrer le fichier et le nom de fichier que vous souhaitez utiliser. Les chemins absolus, les chemins vides et les chemins contenant des références arrières  (../) provoqueront une erreur. Si elle est omise, cette valeur sera par défaut le nom de fichier déjà donné au fichier de téléchargement, et un emplacement immédiatement dans le répertoire de téléchargement.
+
headers{{optional_inline}}
+
Si l'URL utilise les protocoles HTTP ou HTTPS, un array d'objects représentant des en-têtes HTTP supplémentaires à envoyer avec la requête. Chaque en-tête est représenté sous la forme d'un objet dictionnaire contenant le name des clés et soit la value, soit la valeur binaryValue. Les en-têtes interdits par XMLHttpRequest et fetch ne peuvent pas être spécifiés, cependant, Firefox 70 et les versions ultérieures permettent d'utiliser l'en-tête Referer. Tenter d'utiliser un en-tête interdit provoque une erreur.
+
incognito{{optional_inline}}
+
Un boolean: s'il est présent et défini sur true, associez ce téléchargement à une session de navigation privée. Cela signifie qu'il n'apparaîtra dans le gestionnaire de téléchargement que pour les fenêtres privées actuellement ouvertes.
+
method{{optional_inline}}
+
Un string représentant la méthode HTTP à utiliser si l'url utilise le protocole HTTP[S]. Cela peut être "GET" ou "POST".
+
saveAs{{optional_inline}}
+
+

Un boolean qui spécifie s'il faut fournir une boîte de dialogue de sélection de fichier pour permettre à l'utilisateur de sélectionner un nom de fichier (true), ou non (false).

+ +

Si cette option est omise, le navigateur affichera le sélecteur de fichier ou non en fonction de la préférence générale de l'utilisateur pour ce comportement (dans Firefox cette préférence est intitulée "Toujours vous demander où enregistrer les fichiers" dans about:preferences, ou browser.download.useDownloadDir dans about:config).

+ +
+

Note : Firefox pour Android provoque une erreur si saveAs est à  true. Le paramètre est ignoré lorsque saveAs est false ou non inclus.

+
+
+
url
+
Un string représentant l'URL à télécharger.
+
+
+
+ +

Valeur retournée

+ +

Une Promise. Si le téléchargement a démarré avec succès, la promesse sera remplie avec l'id de la nouvelle {{WebExtAPIRef("downloads.DownloadItem")}}. Sinon, la promesse sera rejetée avec un message d'erreur venant de  {{WebExtAPIRef("downloads.InterruptReason")}}.

+ +

Si vous utilisez URL.createObjectURL() pour télécharger des données créées en JavaScript et que vous voulez révoquer l'URL de l'objet (avec revokeObjectURL) plus tard (comme il est fortement recommandé), vous devez le faire après le téléchargement. Pour ce faire, écoutez l'événement downloads.onChanged.

+ +

Compatibilité du navigateur

+ +

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

+ +

Examples

+ +

Le fragment suivant tente de télécharger un exemple de fichier, en spécifiant également un nom de fichier et un emplacement pour l'enregistrer, ainsi que l'option uniquify conflictAction.

+ +
function onStartedDownload(id) {
+  console.log(`Started downloading: ${id}`);
+}
+
+function onFailed(error) {
+  console.log(`Download failed: ${error}`);
+}
+
+var downloadUrl = "https://example.org/image.png";
+
+var downloading = browser.downloads.download({
+  url : downloadUrl,
+  filename : 'my-image-again.png',
+  conflictAction : 'uniquify'
+});
+
+downloading.then(onStartedDownload, onFailed);
+ +

{{WebExtExamples}}

+ +

Note :

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.html deleted file mode 100644 index 98fcbe438f..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: downloads.DownloadItem -slug: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem -tags: - - API - - Add-ons - - DownloadItem - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem ---- -
{{AddonSidebar()}}
- -

Le type DownloadItem de l'API {{WebExtAPIRef("downloads")}} représente un fichier téléchargé.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
byExtensionId{{optional_inline}}
-
Un string représentant l'ID de l'extension qui a déclenché le téléchargement (si elle a été déclenchée par une extension). Cela ne change pas une fois réglé. Si le téléchargement n'a pas été déclenché par une extension, ceci n'est pas défini.
-
byExtensionName{{optional_inline}}
-
Un string représentant le nom de l'extension qui a déclenché le téléchargement (si elle a été déclenchée par une extension). Cela peut changer si l'extension change de nom ou si l'utilisateur change ses paramètres régionaux. Si le téléchargement n'a pas été déclenché par une extension, ceci n'est pas défini.
-
bytesReceived
-
Un number représentant le nombre d'octets reçus jusqu'ici de l'hôte pendant le téléchargement ; cela ne prend pas en compte la compression de fichier.
-
canResume
-
Un boolean indiquant si un téléchargement actuellement interrompu (par exemple en pause) peut être repris à partir du point où il a été interrompu (true), ou non (false).
-
danger
-
Une chaîne indiquant si ce téléchargement est considéré comme sûr ou suspect. Ses valeurs possibles sont définies dans le type  {{WebExtAPIRef('downloads.DangerType')}}.
-
endTime{{optional_inline}}
-
Un string (au format ISO 8601) représentant le nombre de millisecondes entre l'époque UNIX et la fin de ce téléchargement. Ceci n'est pas défini si le téléchargement n'est pas encore terminé.
-
error{{optional_inline}}
-
Une chaîne indiquant pourquoi un téléchargement a été interrompu. Les valeurs possibles sont définies dans le type {{WebExtAPIRef('downloads.InterruptReason')}}. Ceci n'est pas défini si une erreur ne s'est pas produite.
-
estimatedEndTime{{optional_inline}}
-
Un string (au format ISO 8601) représentant le nombre estimé de millisecondes entre l'époque UNIX et la date à laquelle ce téléchargement est estimé terminé. Ceci est indéfini s'il n'est pas connu (en particulier, il n'est pas défini dans le  DownloadItem qui est passé dans {{WebExtAPIRef("downloads.onCreated")}}).
-
exists
-
Un boolean indiquant si un fichier téléchargé existe toujours (true) ou non (false). Ces informations peuvent être périmées, car les navigateurs ne surveillent pas automatiquement la suppression des fichiers. Pour vérifier si un fichier existe, appelez la méthode {{WebExtAPIRef('downloads.search()')}}, en filtrant le fichier question.
-
filename
-
Un string représentant le chemin local absolu du fichier.
-
fileSize
-
Un number indiquant le nombre total d'octets dans le fichier entier, après décompression. La valeur -1 signifie que la taille totale du fichier est inconnue.
-
id
-
Un integer représentant un identifiant unique pour le fichier téléchargé qui est persistant entre les sessions du navigateur.
-
incognito
-
Un boolean qui indique si le téléchargement est enregistré dans l'historique du navigateur (false), ou non (true).
-
mime
-
Un string représentant le type MIME du fichier téléchargé.
-
paused
-
Un boolean indiquant si le téléchargement est en pause, c'est-à-dire si le téléchargement a cessé de lire les données de l'hôte mais a maintenu la connexion ouverte. Si c'est le cas, la valeur est true, sinon false.
-
referrer
-
Un string représentant le référent du fichier téléchargé.
-
startTime
-
Un string (au format ISO 8601) représentant le nombre de millisecondes entre l'époque UNIX et le début du téléchargement.
-
state
-
Un string Indique si le téléchargement progresse, est interrompu ou terminé. Les valeurs possibles sont définies dans le type {{WebExtAPIRef('downloads.State')}}.
-
totalBytes
-
Un number indiquant le nombre total d'octets dans le fichier en cours de téléchargement. Cela ne prend pas en compte la compression de fichier. Une valeur de -1 signifie que le nombre total d'octets est inconnu..
-
url
-
Un string représentant l'URL absolue à partir de laquelle le fichier a été téléchargé.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md new file mode 100644 index 0000000000..98fcbe438f --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md @@ -0,0 +1,109 @@ +--- +title: downloads.DownloadItem +slug: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem +tags: + - API + - Add-ons + - DownloadItem + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem +--- +
{{AddonSidebar()}}
+ +

Le type DownloadItem de l'API {{WebExtAPIRef("downloads")}} représente un fichier téléchargé.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
byExtensionId{{optional_inline}}
+
Un string représentant l'ID de l'extension qui a déclenché le téléchargement (si elle a été déclenchée par une extension). Cela ne change pas une fois réglé. Si le téléchargement n'a pas été déclenché par une extension, ceci n'est pas défini.
+
byExtensionName{{optional_inline}}
+
Un string représentant le nom de l'extension qui a déclenché le téléchargement (si elle a été déclenchée par une extension). Cela peut changer si l'extension change de nom ou si l'utilisateur change ses paramètres régionaux. Si le téléchargement n'a pas été déclenché par une extension, ceci n'est pas défini.
+
bytesReceived
+
Un number représentant le nombre d'octets reçus jusqu'ici de l'hôte pendant le téléchargement ; cela ne prend pas en compte la compression de fichier.
+
canResume
+
Un boolean indiquant si un téléchargement actuellement interrompu (par exemple en pause) peut être repris à partir du point où il a été interrompu (true), ou non (false).
+
danger
+
Une chaîne indiquant si ce téléchargement est considéré comme sûr ou suspect. Ses valeurs possibles sont définies dans le type  {{WebExtAPIRef('downloads.DangerType')}}.
+
endTime{{optional_inline}}
+
Un string (au format ISO 8601) représentant le nombre de millisecondes entre l'époque UNIX et la fin de ce téléchargement. Ceci n'est pas défini si le téléchargement n'est pas encore terminé.
+
error{{optional_inline}}
+
Une chaîne indiquant pourquoi un téléchargement a été interrompu. Les valeurs possibles sont définies dans le type {{WebExtAPIRef('downloads.InterruptReason')}}. Ceci n'est pas défini si une erreur ne s'est pas produite.
+
estimatedEndTime{{optional_inline}}
+
Un string (au format ISO 8601) représentant le nombre estimé de millisecondes entre l'époque UNIX et la date à laquelle ce téléchargement est estimé terminé. Ceci est indéfini s'il n'est pas connu (en particulier, il n'est pas défini dans le  DownloadItem qui est passé dans {{WebExtAPIRef("downloads.onCreated")}}).
+
exists
+
Un boolean indiquant si un fichier téléchargé existe toujours (true) ou non (false). Ces informations peuvent être périmées, car les navigateurs ne surveillent pas automatiquement la suppression des fichiers. Pour vérifier si un fichier existe, appelez la méthode {{WebExtAPIRef('downloads.search()')}}, en filtrant le fichier question.
+
filename
+
Un string représentant le chemin local absolu du fichier.
+
fileSize
+
Un number indiquant le nombre total d'octets dans le fichier entier, après décompression. La valeur -1 signifie que la taille totale du fichier est inconnue.
+
id
+
Un integer représentant un identifiant unique pour le fichier téléchargé qui est persistant entre les sessions du navigateur.
+
incognito
+
Un boolean qui indique si le téléchargement est enregistré dans l'historique du navigateur (false), ou non (true).
+
mime
+
Un string représentant le type MIME du fichier téléchargé.
+
paused
+
Un boolean indiquant si le téléchargement est en pause, c'est-à-dire si le téléchargement a cessé de lire les données de l'hôte mais a maintenu la connexion ouverte. Si c'est le cas, la valeur est true, sinon false.
+
referrer
+
Un string représentant le référent du fichier téléchargé.
+
startTime
+
Un string (au format ISO 8601) représentant le nombre de millisecondes entre l'époque UNIX et le début du téléchargement.
+
state
+
Un string Indique si le téléchargement progresse, est interrompu ou terminé. Les valeurs possibles sont définies dans le type {{WebExtAPIRef('downloads.State')}}.
+
totalBytes
+
Un number indiquant le nombre total d'octets dans le fichier en cours de téléchargement. Cela ne prend pas en compte la compression de fichier. Une valeur de -1 signifie que le nombre total d'octets est inconnu..
+
url
+
Un string représentant l'URL absolue à partir de laquelle le fichier a été téléchargé.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.html deleted file mode 100644 index 8e3071fb70..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: downloads.DownloadQuery -slug: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery -tags: - - API - - Add-ons - - DownloadQuery - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery ---- -
{{AddonSidebar()}}
- -

Le type DownloadQuery de l'API {{WebExtAPIRef("downloads")}} définit un ensemble de paramètres pouvant être utilisés pour rechercher dans le gestionnaire de téléchargements un ensemble spécifique de téléchargements.

- -

Ce type est utilisé par exemple dans {{WebExtAPIRef("downloads.search()")}} et {{WebExtAPIRef("downloads.erase()")}}, en tant qu'objet de requête pour filtrer l'ensemble de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} pour retourner ou effacer.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

- -
-
query{{optional_inline}}
-
Un tableau dechaines. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le nom de fichier ou l'URL contient toutes les chaînes données. Vous pouvez également inclure des termes commençant par un titet (-) — ces termes ne doivent pas figurer dans le nom du fichier ou l'url de l'élément à inclure.
-
startedBefore{{optional_inline}}
-
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a démarré avant l'heure indiquée.
-
startedAfter{{optional_inline}}
-
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a démarré après l'heure indiquée.
-
endedBefore{{optional_inline}}
-
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminé avant l'heure indiquée.
-
endedAfter{{optional_inline}}
-
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminé après l'heure indiquée.
-
totalBytesGreater{{optional_inline}}
-
Un number représentant un nombre d'octets. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le  totalBytes est supérieur au nombre donné.
-
totalBytesLess{{optional_inline}}
-
Un number représentant un nombre d'octets. Inclure seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le totalBytes est inférieur au nombre donné.
-
filenameRegex{{optional_inline}}
-
Un string représentant une expression régulière. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le nom du fichier correspond à l'expression régulière donnée..
-
urlRegex{{optional_inline}}
-
Un string représentant une expression régulière. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont la valeur d'url correspond à l'expression régulière donnée..
-
limit{{optional_inline}}
-
Un integer représentant un nombre de résultats. Incluez uniquement le nombre spécifié de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}.
-
orderBy{{optional_inline}}
-
Un tableaude chaînes représentant les propriétés  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} les résultats de la recherche doivent être tirés par exemple, en incluant startTime puis totalBytes dans le tableau trierait {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} par leur heure de début, puis le total des octets — dans l'ordre croissant. Pour spécifier le tri par une propriété dans l'ordre décroissant, préfixez-le avec un trait d'union, par exemple -startTime.
-
id{{optional_inline}}
-
Un integer représentant l'ID du {{WebExtAPIRef("downloads.DownloadItem")}} que vous souhaitez interroger.
-
url{{optional_inline}}
-
Un string représentant l'URL absolue à partir de laquelle le téléchargement a été initié, avant toute redirection.
-
filename{{optional_inline}}
-
Un string représentant le chemin local absolu du fichier téléchargé que vous souhaitez interroger.
-
danger{{optional_inline}}
-
Une chaîne représentant un {{WebExtAPIRef('downloads.DangerType')}} — inclut uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de danger .
-
mime{{optional_inline}}
-
Un string représentant un type MIME. Incluez uniquement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur mime.
-
startTime{{optional_inline}}
-
Un string représentant une heure au format ISO 8601. Incluez seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur  startTime.
-
endTime{{optional_inline}}
-
Un string représentant une heure au format ISO 8601. Inclure uniquement sera limité à {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur endTime.
-
state{{optional_inline}}
-
Un string représentant un téléchargement {{WebExtAPIRef('downloads.State')}} (in_progress, interrupted, or complete). Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d' état.
-
paused{{optional_inline}}
-
Un boolean qui indique si un téléchargement est en pause — c'est-à-dire qui a cessé de lire les données de l'hôte, mais qui a conservé la connexion ouverte (true), ou non (false). inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de pause.
-
error{{optional_inline}}
-
Une chaîne représentant un {{WebExtAPIRef('downloads.InterruptReason')}} — une raison pour laquelle un téléchargement a été interrompu. Inclure uniquement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d'  erreur .
-
bytesReceived{{optional_inline}}
-
Un number représentant le nombre d'octets reçus jusqu'ici de l'hôte, sans tenir compte de la compression de fichier. Inclure seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur bytesReceived.
-
totalBytes{{optional_inline}}
-
Un number représentant le nombre total d'octets dans le fichier téléchargé, sans tenir compte de la compression de fichier. Inclure seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur  totalBytes.
-
fileSize{{optional_inline}}
-
number. Nombre d'octets dans le fichier entier après la décompression, ou -1 si inconnu. Un nombre représentant le nombre total d'octets dans le fichier après la décompression. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur fileSize.
-
exists{{optional_inline}}
-
Un boolean si un fichier téléchargé existe toujours (true) ou non (false). Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur existe.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md new file mode 100644 index 0000000000..8e3071fb70 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md @@ -0,0 +1,120 @@ +--- +title: downloads.DownloadQuery +slug: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery +tags: + - API + - Add-ons + - DownloadQuery + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery +--- +
{{AddonSidebar()}}
+ +

Le type DownloadQuery de l'API {{WebExtAPIRef("downloads")}} définit un ensemble de paramètres pouvant être utilisés pour rechercher dans le gestionnaire de téléchargements un ensemble spécifique de téléchargements.

+ +

Ce type est utilisé par exemple dans {{WebExtAPIRef("downloads.search()")}} et {{WebExtAPIRef("downloads.erase()")}}, en tant qu'objet de requête pour filtrer l'ensemble de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} pour retourner ou effacer.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :

+ +
+
query{{optional_inline}}
+
Un tableau dechaines. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le nom de fichier ou l'URL contient toutes les chaînes données. Vous pouvez également inclure des termes commençant par un titet (-) — ces termes ne doivent pas figurer dans le nom du fichier ou l'url de l'élément à inclure.
+
startedBefore{{optional_inline}}
+
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a démarré avant l'heure indiquée.
+
startedAfter{{optional_inline}}
+
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui a démarré après l'heure indiquée.
+
endedBefore{{optional_inline}}
+
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminé avant l'heure indiquée.
+
endedAfter{{optional_inline}}
+
Un {{WebExtAPIRef('downloads.DownloadTime', "DownloadTime")}}. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} qui s'est terminé après l'heure indiquée.
+
totalBytesGreater{{optional_inline}}
+
Un number représentant un nombre d'octets. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le  totalBytes est supérieur au nombre donné.
+
totalBytesLess{{optional_inline}}
+
Un number représentant un nombre d'octets. Inclure seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le totalBytes est inférieur au nombre donné.
+
filenameRegex{{optional_inline}}
+
Un string représentant une expression régulière. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont le nom du fichier correspond à l'expression régulière donnée..
+
urlRegex{{optional_inline}}
+
Un string représentant une expression régulière. Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} dont la valeur d'url correspond à l'expression régulière donnée..
+
limit{{optional_inline}}
+
Un integer représentant un nombre de résultats. Incluez uniquement le nombre spécifié de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}.
+
orderBy{{optional_inline}}
+
Un tableaude chaînes représentant les propriétés  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} les résultats de la recherche doivent être tirés par exemple, en incluant startTime puis totalBytes dans le tableau trierait {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} par leur heure de début, puis le total des octets — dans l'ordre croissant. Pour spécifier le tri par une propriété dans l'ordre décroissant, préfixez-le avec un trait d'union, par exemple -startTime.
+
id{{optional_inline}}
+
Un integer représentant l'ID du {{WebExtAPIRef("downloads.DownloadItem")}} que vous souhaitez interroger.
+
url{{optional_inline}}
+
Un string représentant l'URL absolue à partir de laquelle le téléchargement a été initié, avant toute redirection.
+
filename{{optional_inline}}
+
Un string représentant le chemin local absolu du fichier téléchargé que vous souhaitez interroger.
+
danger{{optional_inline}}
+
Une chaîne représentant un {{WebExtAPIRef('downloads.DangerType')}} — inclut uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de danger .
+
mime{{optional_inline}}
+
Un string représentant un type MIME. Incluez uniquement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur mime.
+
startTime{{optional_inline}}
+
Un string représentant une heure au format ISO 8601. Incluez seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur  startTime.
+
endTime{{optional_inline}}
+
Un string représentant une heure au format ISO 8601. Inclure uniquement sera limité à {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur endTime.
+
state{{optional_inline}}
+
Un string représentant un téléchargement {{WebExtAPIRef('downloads.State')}} (in_progress, interrupted, or complete). Inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d' état.
+
paused{{optional_inline}}
+
Un boolean qui indique si un téléchargement est en pause — c'est-à-dire qui a cessé de lire les données de l'hôte, mais qui a conservé la connexion ouverte (true), ou non (false). inclure uniquement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur de pause.
+
error{{optional_inline}}
+
Une chaîne représentant un {{WebExtAPIRef('downloads.InterruptReason')}} — une raison pour laquelle un téléchargement a été interrompu. Inclure uniquement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur d'  erreur .
+
bytesReceived{{optional_inline}}
+
Un number représentant le nombre d'octets reçus jusqu'ici de l'hôte, sans tenir compte de la compression de fichier. Inclure seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur bytesReceived.
+
totalBytes{{optional_inline}}
+
Un number représentant le nombre total d'octets dans le fichier téléchargé, sans tenir compte de la compression de fichier. Inclure seulement  {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur  totalBytes.
+
fileSize{{optional_inline}}
+
number. Nombre d'octets dans le fichier entier après la décompression, ou -1 si inconnu. Un nombre représentant le nombre total d'octets dans le fichier après la décompression. Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur fileSize.
+
exists{{optional_inline}}
+
Un boolean si un fichier téléchargé existe toujours (true) ou non (false). Inclure seulement {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} avec cette valeur existe.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.html deleted file mode 100644 index a956cd5a93..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: downloads.DownloadTime -slug: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime -tags: - - API - - Add-ons - - DownloadTime - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime ---- -
{{AddonSidebar()}}
- -

Le type DownloadTime de l'API {{WebExtAPIRef("downloads")}} représente le temps nécessaire au téléchargement.

- -

Type

- -

Un DownloadTime peut être l'un de trois types différents :

- - - -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md new file mode 100644 index 0000000000..a956cd5a93 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md @@ -0,0 +1,77 @@ +--- +title: downloads.DownloadTime +slug: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime +tags: + - API + - Add-ons + - DownloadTime + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime +--- +
{{AddonSidebar()}}
+ +

Le type DownloadTime de l'API {{WebExtAPIRef("downloads")}} représente le temps nécessaire au téléchargement.

+ +

Type

+ +

Un DownloadTime peut être l'un de trois types différents :

+ + + +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.html deleted file mode 100644 index 353f70f26a..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: downloads.drag() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/drag -tags: - - API - - Add-ons - - Drag - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/drag ---- -
{{AddonSidebar()}}
- -

La fonction  drag() de l'API {{WebExtAPIRef("downloads")}} initie le glissement du fichier téléchargé vers une autre application.

- -

Syntaxe

- -
chrome.downloads.drag(
-  downloadId // integer
-)
-
- -

Cette API est également disponible en tant que browser.downloads.drag().

- -

Paramètres

- -
-
downloadId
-
Un integer représentant l'id du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} ein question.
-
- -

Browser compatibility

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md new file mode 100644 index 0000000000..353f70f26a --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md @@ -0,0 +1,78 @@ +--- +title: downloads.drag() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/drag +tags: + - API + - Add-ons + - Drag + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/drag +--- +
{{AddonSidebar()}}
+ +

La fonction  drag() de l'API {{WebExtAPIRef("downloads")}} initie le glissement du fichier téléchargé vers une autre application.

+ +

Syntaxe

+ +
chrome.downloads.drag(
+  downloadId // integer
+)
+
+ +

Cette API est également disponible en tant que browser.downloads.drag().

+ +

Paramètres

+ +
+
downloadId
+
Un integer représentant l'id du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} ein question.
+
+ +

Browser compatibility

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.html deleted file mode 100644 index 44d9d1fe46..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: downloads.erase() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/erase -tags: - - API - - Add-ons - - Effacer - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads - - erase -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/erase ---- -
{{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.

- -

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

- -

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 {{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

- -
var erasing = browser.downloads.erase(
-  query                    // DownloadQuery
-)
-
- -

Paramètres

- -
-
query
-
Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.
-
- -

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.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

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

- -
function onErased(ids) {
-  console.log(`Erased: ${ids}`);
-}
-
-function onError(error) {
-  console.log(`Error erasing item: ${error}`);
-}
-
-var erasing = browser.downloads.erase({
-  limit: 1,
-  orderBy: ["-startTime"]
-});
-
-erasing.then(onErased, onError);
- -

Tout effacer :

- -
function onErased(ids) {
-  console.log(`Erased: ${ids}`);
-}
-
-function onError(error) {
-  console.log(`Error erasing item: ${error}`);
-}
-
-var erasing = browser.downloads.erase({});
-erasing.then(onErased, 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.

-
- - 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 new file mode 100644 index 0000000000..44d9d1fe46 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md @@ -0,0 +1,121 @@ +--- +title: downloads.erase() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/erase +tags: + - API + - Add-ons + - Effacer + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - erase +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/erase +--- +
{{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.

+ +

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

+ +

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 {{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

+ +
var erasing = browser.downloads.erase(
+  query                    // DownloadQuery
+)
+
+ +

Paramètres

+ +
+
query
+
Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.
+
+ +

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.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

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

+ +
function onErased(ids) {
+  console.log(`Erased: ${ids}`);
+}
+
+function onError(error) {
+  console.log(`Error erasing item: ${error}`);
+}
+
+var erasing = browser.downloads.erase({
+  limit: 1,
+  orderBy: ["-startTime"]
+});
+
+erasing.then(onErased, onError);
+ +

Tout effacer :

+ +
function onErased(ids) {
+  console.log(`Erased: ${ids}`);
+}
+
+function onError(error) {
+  console.log(`Error erasing item: ${error}`);
+}
+
+var erasing = browser.downloads.erase({});
+erasing.then(onErased, 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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.html deleted file mode 100644 index 6d1c4c0709..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: downloads.FilenameConflictAction -slug: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictAction -tags: - - API - - Add-ons - - Extensions - - FilenameConflitAction - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictAction ---- -
{{AddonSidebar()}}
- -

Le type FilenameConflictAction de l'API {{WebExtAPIRef("downloads")}} spécifie que faire si le nom d'un fichier téléchargé est en conflit avec un fichier existant.

- -

Ce type définit les valeurs pouvant être utilisées pour la propriété conflictAction du paramètre d'options {{WebExtAPIRef("downloads.download")}}.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

- -
-
"uniquify"
-
Le navigateur modifiera le nom de fichier pour le rendre unique.
-
"overwrite"
-
Le navigateur écrase l'ancien fichier avec le fichier nouvellement téléchargé.
-
"prompt"
-
Le navigateur invitera l'utilisateur, lui demandant de choisir s'il souhaite l'uniquifier ou l'écraser.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md new file mode 100644 index 0000000000..6d1c4c0709 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md @@ -0,0 +1,77 @@ +--- +title: downloads.FilenameConflictAction +slug: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictAction +tags: + - API + - Add-ons + - Extensions + - FilenameConflitAction + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictAction +--- +
{{AddonSidebar()}}
+ +

Le type FilenameConflictAction de l'API {{WebExtAPIRef("downloads")}} spécifie que faire si le nom d'un fichier téléchargé est en conflit avec un fichier existant.

+ +

Ce type définit les valeurs pouvant être utilisées pour la propriété conflictAction du paramètre d'options {{WebExtAPIRef("downloads.download")}}.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

+ +
+
"uniquify"
+
Le navigateur modifiera le nom de fichier pour le rendre unique.
+
"overwrite"
+
Le navigateur écrase l'ancien fichier avec le fichier nouvellement téléchargé.
+
"prompt"
+
Le navigateur invitera l'utilisateur, lui demandant de choisir s'il souhaite l'uniquifier ou l'écraser.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.html deleted file mode 100644 index 7fb93c5494..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: downloads.getFileIcon() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/getFileIcon -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads - - getFileIcon -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/getFileIcon ---- -
{{AddonSidebar()}}
- -

La fonction getFileIcon() de l'API {{WebExtAPIRef("downloads")}} récupère une icône pour le téléchargement spécifié.

- -

Pour les nouveaux téléchargements, les icônes de fichiers sont disponibles après la réception de l'événement {{WebExtAPIRef("downloads.onCreated")}}. L'image renvoyée par cette fonction pendant le téléchargement peut être différente de l'image renvoyée une fois le téléchargement terminé.

- -

La récupération d'icônes s'effectue en interrogeant la plateforme sous-jacente. L'icône renvoyée dépendra donc d'un certain nombre de facteurs, notamment l'état du téléchargement, la plate-forme, les types de fichiers enregistrés et le thème visuel.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var gettingIcon = browser.downloads.getFileIcon(
-  downloadId,           // integer
-  options               // optional object
-)
-
- -

Paramètres

- -
-
downloadId
-
Un integer eprésentant l'ID du téléchargement.
-
options{{optional_inline}}
-

Un object d'options représentant les préférences pour l'icône à extraire. Il peut prendre les propriétés suivantes :

-
-
size{{optional_inline}}
-
Un integer représentant la taille de l'icône. La taille de l'icône retournée sera la taille fournie au carré (en pixels). Si elle est omise, la taille par défaut de l'icône est 32x32 pixels.
-
-
-
- -

Valeur retournée

- -

Une Promise. Si la requête réussit, la promesse sera remplie avec une chaîne représentant l'URL absolue de l'icône. Si la requête échoue, la promesse sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Cet exemple enregistre l'URL de l'icône pour le téléchargement le plus récent :

- -
function gotIcon(iconUrl) {
-  console.log(iconUrl);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-function getIcon(downloadItems) {
-    if (downloadItems.length > 0) {
-      latestDownloadId = downloadItems[0].id;
-      var gettingIcon = browser.downloads.getFileIcon(latestDownloadId);
-      gettingIcon.then(gotIcon, onError);
-    }
-  }
-
-var searching = browser.downloads.search({
-  limit: 1,
-  orderBy: ["-startTime"]
-});
-
-searching.then(getIcon, 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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md new file mode 100644 index 0000000000..7fb93c5494 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md @@ -0,0 +1,121 @@ +--- +title: downloads.getFileIcon() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/getFileIcon +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - getFileIcon +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/getFileIcon +--- +
{{AddonSidebar()}}
+ +

La fonction getFileIcon() de l'API {{WebExtAPIRef("downloads")}} récupère une icône pour le téléchargement spécifié.

+ +

Pour les nouveaux téléchargements, les icônes de fichiers sont disponibles après la réception de l'événement {{WebExtAPIRef("downloads.onCreated")}}. L'image renvoyée par cette fonction pendant le téléchargement peut être différente de l'image renvoyée une fois le téléchargement terminé.

+ +

La récupération d'icônes s'effectue en interrogeant la plateforme sous-jacente. L'icône renvoyée dépendra donc d'un certain nombre de facteurs, notamment l'état du téléchargement, la plate-forme, les types de fichiers enregistrés et le thème visuel.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var gettingIcon = browser.downloads.getFileIcon(
+  downloadId,           // integer
+  options               // optional object
+)
+
+ +

Paramètres

+ +
+
downloadId
+
Un integer eprésentant l'ID du téléchargement.
+
options{{optional_inline}}
+

Un object d'options représentant les préférences pour l'icône à extraire. Il peut prendre les propriétés suivantes :

+
+
size{{optional_inline}}
+
Un integer représentant la taille de l'icône. La taille de l'icône retournée sera la taille fournie au carré (en pixels). Si elle est omise, la taille par défaut de l'icône est 32x32 pixels.
+
+
+
+ +

Valeur retournée

+ +

Une Promise. Si la requête réussit, la promesse sera remplie avec une chaîne représentant l'URL absolue de l'icône. Si la requête échoue, la promesse sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Cet exemple enregistre l'URL de l'icône pour le téléchargement le plus récent :

+ +
function gotIcon(iconUrl) {
+  console.log(iconUrl);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+function getIcon(downloadItems) {
+    if (downloadItems.length > 0) {
+      latestDownloadId = downloadItems[0].id;
+      var gettingIcon = browser.downloads.getFileIcon(latestDownloadId);
+      gettingIcon.then(gotIcon, onError);
+    }
+  }
+
+var searching = browser.downloads.search({
+  limit: 1,
+  orderBy: ["-startTime"]
+});
+
+searching.then(getIcon, 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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.html deleted file mode 100644 index 3a5af5f188..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/index.html +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: downloads -slug: Mozilla/Add-ons/WebExtensions/API/downloads -tags: - - API - - Add-ons - - Extensions - - Interface - - Non-standard - - Reference - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads ---- -
{{AddonSidebar}}
- -

Permet aux extensions d'interagir avec le gestionnaire de téléchargement du navigateur. Vous pouvez utiliser ce module API pour télécharger des fichiers, annuler, suspendre, reprendre des téléchargements et afficher les fichiers téléchargés dans le gestionnaire de fichiers.

- -

Pour utiliser cette API, vous devez disposer de l' API permission "downloads" spécifiée dans votre fichier manifest.json.

- -

Types

- -
-
{{WebExtAPIRef("downloads.FilenameConflictAction")}}
-
Définit les options pour ce qu'il faut faire si le nom d'un fichier téléchargé est en conflit avec un fichier existant.
-
{{WebExtAPIRef("downloads.InterruptReason")}}
-
Définit un ensemble de raisons possibles pour lesquelles un téléchargement a été interrompu.
-
{{WebExtAPIRef("downloads.DangerType")}}
-
Définit un ensemble d'avertissements communs des dangers possibles associés aux fichiers téléchargeables.
-
{{WebExtAPIRef("downloads.State")}}
-
Définit différents états dans lesquels un téléchargement en cours peut être.
-
{{WebExtAPIRef("downloads.DownloadItem")}}
-
Représente un fichier téléchargé.
-
{{WebExtAPIRef("downloads.StringDelta")}}
-
Représente la différence entre deux chaînes.
-
{{WebExtAPIRef("downloads.DoubleDelta")}}
-
Représente la différence entre deux doubles.
-
{{WebExtAPIRef("downloads.BooleanDelta")}}
-
Représente la différence entre deux booléens.
-
{{WebExtAPIRef("downloads.DownloadTime")}}
-
Représente le temps nécessaire au téléchargement pour terminer.
-
{{WebExtAPIRef("downloads.DownloadQuery")}}
-
Définit un ensemble de paramètres pouvant être utilisés pour rechercher dans le gestionnaire de téléchargements un ensemble de téléchargements spécifique.
-
- -

Fonctions

- -
-
{{WebExtAPIRef("downloads.download()")}}
-
Télécharge un fichier, compte tenu de son URL et d'autres préférences optionnelles.
-
{{WebExtAPIRef("downloads.search()")}}
-
Interroge le {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponible dans le gestionnaire de téléchargements du navigateur et renvoie ceux qui correspondent aux critères de recherche spécifiés.
-
{{WebExtAPIRef("downloads.pause()")}}
-
Suspend un téléchargement.
-
{{WebExtAPIRef("downloads.resume()")}}
-
Reprend un téléchargement suspendu.
-
{{WebExtAPIRef("downloads.cancel()")}}
-
Annule un téléchargement.
-
{{WebExtAPIRef("downloads.getFileIcon()")}}
-
Récupère une icône pour le téléchargement spécifié.
-
{{WebExtAPIRef("downloads.open()")}}
-
Ouvre le fichier téléchargé avec son application associée.
-
{{WebExtAPIRef("downloads.show()")}}
-
Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le fichier téléchargé dans son dossier conteneur.
-
{{WebExtAPIRef("downloads.showDefaultFolder()")}}
-
Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le dossier de téléchargements par défaut.
-
{{WebExtAPIRef("downloads.erase()")}}
-
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.
-
{{WebExtAPIRef("downloads.removeFile()")}}
-
Supprime un fichier téléchargé du disque, mais pas de l'historique de téléchargement du navigateur.
-
{{WebExtAPIRef("downloads.acceptDanger()")}}
-
Invite l'utilisateur à accepter ou annuler un téléchargement dangereux.
-
{{WebExtAPIRef("downloads.drag()")}}
-
Lance le glissement du fichier téléchargé vers une autre application.
-
{{WebExtAPIRef("downloads.setShelfEnabled()")}}
-
Active ou désactive l'étagère grise en bas de chaque fenêtre associée au profil de navigateur actuel. L'étagère sera désactivée si au moins une extension l'a désactivée.
-
- -

Evénements

- -
-
{{WebExtAPIRef("downloads.onCreated")}}
-
Se déclenche avec l'objet {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} lorsqu'un téléchargement commence.
-
{{WebExtAPIRef("downloads.onErased")}}
-
Se déclenche avec downloadId lorsqu'un téléchargement est effacé de l'historique.
-
{{WebExtAPIRef("downloads.onChanged")}}
-
Lorsque l'une des propriétés de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} sauf les changements bytesReceived, cet événement se déclenche avec le downloadId et un objet contenant les propriétés qui ont changé.
-
- -

Compatibilité du navigateur

- -

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

- -

{{WebExtExamples("h2")}}

- -

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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md new file mode 100644 index 0000000000..3a5af5f188 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md @@ -0,0 +1,132 @@ +--- +title: downloads +slug: Mozilla/Add-ons/WebExtensions/API/downloads +tags: + - API + - Add-ons + - Extensions + - Interface + - Non-standard + - Reference + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads +--- +
{{AddonSidebar}}
+ +

Permet aux extensions d'interagir avec le gestionnaire de téléchargement du navigateur. Vous pouvez utiliser ce module API pour télécharger des fichiers, annuler, suspendre, reprendre des téléchargements et afficher les fichiers téléchargés dans le gestionnaire de fichiers.

+ +

Pour utiliser cette API, vous devez disposer de l' API permission "downloads" spécifiée dans votre fichier manifest.json.

+ +

Types

+ +
+
{{WebExtAPIRef("downloads.FilenameConflictAction")}}
+
Définit les options pour ce qu'il faut faire si le nom d'un fichier téléchargé est en conflit avec un fichier existant.
+
{{WebExtAPIRef("downloads.InterruptReason")}}
+
Définit un ensemble de raisons possibles pour lesquelles un téléchargement a été interrompu.
+
{{WebExtAPIRef("downloads.DangerType")}}
+
Définit un ensemble d'avertissements communs des dangers possibles associés aux fichiers téléchargeables.
+
{{WebExtAPIRef("downloads.State")}}
+
Définit différents états dans lesquels un téléchargement en cours peut être.
+
{{WebExtAPIRef("downloads.DownloadItem")}}
+
Représente un fichier téléchargé.
+
{{WebExtAPIRef("downloads.StringDelta")}}
+
Représente la différence entre deux chaînes.
+
{{WebExtAPIRef("downloads.DoubleDelta")}}
+
Représente la différence entre deux doubles.
+
{{WebExtAPIRef("downloads.BooleanDelta")}}
+
Représente la différence entre deux booléens.
+
{{WebExtAPIRef("downloads.DownloadTime")}}
+
Représente le temps nécessaire au téléchargement pour terminer.
+
{{WebExtAPIRef("downloads.DownloadQuery")}}
+
Définit un ensemble de paramètres pouvant être utilisés pour rechercher dans le gestionnaire de téléchargements un ensemble de téléchargements spécifique.
+
+ +

Fonctions

+ +
+
{{WebExtAPIRef("downloads.download()")}}
+
Télécharge un fichier, compte tenu de son URL et d'autres préférences optionnelles.
+
{{WebExtAPIRef("downloads.search()")}}
+
Interroge le {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponible dans le gestionnaire de téléchargements du navigateur et renvoie ceux qui correspondent aux critères de recherche spécifiés.
+
{{WebExtAPIRef("downloads.pause()")}}
+
Suspend un téléchargement.
+
{{WebExtAPIRef("downloads.resume()")}}
+
Reprend un téléchargement suspendu.
+
{{WebExtAPIRef("downloads.cancel()")}}
+
Annule un téléchargement.
+
{{WebExtAPIRef("downloads.getFileIcon()")}}
+
Récupère une icône pour le téléchargement spécifié.
+
{{WebExtAPIRef("downloads.open()")}}
+
Ouvre le fichier téléchargé avec son application associée.
+
{{WebExtAPIRef("downloads.show()")}}
+
Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le fichier téléchargé dans son dossier conteneur.
+
{{WebExtAPIRef("downloads.showDefaultFolder()")}}
+
Ouvre l'application du gestionnaire de fichiers de la plateforme pour afficher le dossier de téléchargements par défaut.
+
{{WebExtAPIRef("downloads.erase()")}}
+
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.
+
{{WebExtAPIRef("downloads.removeFile()")}}
+
Supprime un fichier téléchargé du disque, mais pas de l'historique de téléchargement du navigateur.
+
{{WebExtAPIRef("downloads.acceptDanger()")}}
+
Invite l'utilisateur à accepter ou annuler un téléchargement dangereux.
+
{{WebExtAPIRef("downloads.drag()")}}
+
Lance le glissement du fichier téléchargé vers une autre application.
+
{{WebExtAPIRef("downloads.setShelfEnabled()")}}
+
Active ou désactive l'étagère grise en bas de chaque fenêtre associée au profil de navigateur actuel. L'étagère sera désactivée si au moins une extension l'a désactivée.
+
+ +

Evénements

+ +
+
{{WebExtAPIRef("downloads.onCreated")}}
+
Se déclenche avec l'objet {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} lorsqu'un téléchargement commence.
+
{{WebExtAPIRef("downloads.onErased")}}
+
Se déclenche avec downloadId lorsqu'un téléchargement est effacé de l'historique.
+
{{WebExtAPIRef("downloads.onChanged")}}
+
Lorsque l'une des propriétés de {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} sauf les changements bytesReceived, cet événement se déclenche avec le downloadId et un objet contenant les propriétés qui ont changé.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{WebExtExamples("h2")}}

+ +

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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.html deleted file mode 100644 index fa29a664f6..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.html +++ /dev/null @@ -1,117 +0,0 @@ ---- -title: downloads.InterruptReason -slug: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason -tags: - - API - - Add-ons - - Extensions - - InterruptReason - - Non-standard - - Reference - - Type - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason ---- -
{{AddonSidebar()}}
- -

Le type InteruptReason de l'API {{WebExtAPIRef("downloads")}} définit un ensemble de raisons possibles pour lesquelles un téléchargement a été interrompu.

- -

Une propriété {{WebExtAPIRef('downloads.DownloadItem')}} d'erreur contiendra une chaîne tirée des valeurs définies dans ce type.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont divisées en catégories, chaque ensemble ayant la même sous-chaîne au début:

- -

Erreurs liées au fichier :

- - - -

Erreurs liées au réseau :

- - - -

Erreurs liées au serveur :

- - - -

Erreurs liées à l'utilisateur :

- - - -

Divers :

- - - -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md new file mode 100644 index 0000000000..fa29a664f6 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md @@ -0,0 +1,117 @@ +--- +title: downloads.InterruptReason +slug: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason +tags: + - API + - Add-ons + - Extensions + - InterruptReason + - Non-standard + - Reference + - Type + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason +--- +
{{AddonSidebar()}}
+ +

Le type InteruptReason de l'API {{WebExtAPIRef("downloads")}} définit un ensemble de raisons possibles pour lesquelles un téléchargement a été interrompu.

+ +

Une propriété {{WebExtAPIRef('downloads.DownloadItem')}} d'erreur contiendra une chaîne tirée des valeurs définies dans ce type.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont divisées en catégories, chaque ensemble ayant la même sous-chaîne au début:

+ +

Erreurs liées au fichier :

+ + + +

Erreurs liées au réseau :

+ + + +

Erreurs liées au serveur :

+ + + +

Erreurs liées à l'utilisateur :

+ + + +

Divers :

+ + + +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.html deleted file mode 100644 index 5637ace775..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.html +++ /dev/null @@ -1,148 +0,0 @@ ---- -title: downloads.onChanged -slug: Mozilla/Add-ons/WebExtensions/API/downloads/onChanged -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - Téléchargement - - WebExtensions - - downloads - - onChanged -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onChanged ---- -
{{AddonSidebar()}}
- -

L'événement onChanged() de l'API {{WebExtAPIRef("downloads")}} est déclenché lorsque l'une des propriétés de {{WebExtAPIRef('downloads.DownloadItem')}} change (à l'exception de bytesReceived).

- -

L'écouteur reçoit un fichier downloadDelta en tant que paramètre — un objet contenant le downloadId de l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question, plus le statut de toutes les propriétés qui ont changé.

- -

Syntaxe

- -
browser.downloads.onChanged.addListener(listener)
-browser.downloads.onChanged.removeListener(listener)
-browser.downloads.onChanged.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajoute un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifiez si un listener donné est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
-
- -

Syntaxe addListener

- -

Parameters

- -
-
callback
-
-

Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants :

- -
-
downloadDelta
-
Un objet représentant l'objet {{WebExtAPIRef('downloads.DownloadItem')}} qui a été modifié, ainsi que l'état de toutes les propriétés qui y ont été modifiées.
-
-
-
- -

Objets supplémentaires

- -

downloadDelta

- -

L'objet downloadDelta a les propriétés suivantes disponibles :

- -
-
id
-
Un integer représentant l'identifiant de l'id  {{WebExtAPIRef('downloads.DownloadItem')}} qui a changé.
-
url{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant une modification d'une  url {{WebExtAPIRef('downloads.DownloadItem')}}.
-
filename{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un filename {{WebExtAPIRef('downloads.DownloadItem')}}
-
danger{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un danger {{WebExtAPIRef('downloads.DownloadItem')}}.
-
mime{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un mime {{WebExtAPIRef('downloads.DownloadItem')}}
-
startTime{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un startTime {{WebExtAPIRef('downloads.DownloadItem')}}.
-
endTime{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un  endTime {{WebExtAPIRef('downloads.DownloadItem')}}.
-
state{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un état {{WebExtAPIRef('downloads.DownloadItem')}}
-
canResume{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} décrivant un changement dans un état {{WebExtAPIRef('downloads.DownloadItem')}} canResume.
-
paused{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} décrivant un changement dans un état en pause {{WebExtAPIRef('downloads.DownloadItem')}}.
-
error{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un état d'erreur {{WebExtAPIRef('downloads.DownloadItem')}}.
-
totalBytes{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.DoubleDelta')}} décrivant un changement dans un totalBytes {{WebExtAPIRef('downloads.DownloadItem')}}.
-
fileSize{{optional_inline}}
-
Un objet  {{WebExtAPIRef('downloads.DoubleDelta')}} décrivant une modification d'un  fileSize {{WebExtAPIRef('downloads.DownloadItem')}}.
-
exists{{optional_inline}}
-
Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} décrivant un changement dans un état {{WebExtAPIRef('downloads.DownloadItem')}}.
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Enregistrez un message lorsque les téléchargements sont terminés :

- -
function handleChanged(delta) {
-  if (delta.state && delta.state.current === "complete") {
-    console.log(`Download ${delta.id} has completed.`);
-  }
-}
-
-browser.downloads.onChanged.addListener(handleChanged);
- -

{{WebExtExamples}}

- -

Note :

- -

This API is based on Chromium's chrome.downloads API.

- -

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md new file mode 100644 index 0000000000..5637ace775 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md @@ -0,0 +1,148 @@ +--- +title: downloads.onChanged +slug: Mozilla/Add-ons/WebExtensions/API/downloads/onChanged +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - Téléchargement + - WebExtensions + - downloads + - onChanged +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onChanged +--- +
{{AddonSidebar()}}
+ +

L'événement onChanged() de l'API {{WebExtAPIRef("downloads")}} est déclenché lorsque l'une des propriétés de {{WebExtAPIRef('downloads.DownloadItem')}} change (à l'exception de bytesReceived).

+ +

L'écouteur reçoit un fichier downloadDelta en tant que paramètre — un objet contenant le downloadId de l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question, plus le statut de toutes les propriétés qui ont changé.

+ +

Syntaxe

+ +
browser.downloads.onChanged.addListener(listener)
+browser.downloads.onChanged.removeListener(listener)
+browser.downloads.onChanged.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoute un écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifiez si un listener donné est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
+
+ +

Syntaxe addListener

+ +

Parameters

+ +
+
callback
+
+

Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants :

+ +
+
downloadDelta
+
Un objet représentant l'objet {{WebExtAPIRef('downloads.DownloadItem')}} qui a été modifié, ainsi que l'état de toutes les propriétés qui y ont été modifiées.
+
+
+
+ +

Objets supplémentaires

+ +

downloadDelta

+ +

L'objet downloadDelta a les propriétés suivantes disponibles :

+ +
+
id
+
Un integer représentant l'identifiant de l'id  {{WebExtAPIRef('downloads.DownloadItem')}} qui a changé.
+
url{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant une modification d'une  url {{WebExtAPIRef('downloads.DownloadItem')}}.
+
filename{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un filename {{WebExtAPIRef('downloads.DownloadItem')}}
+
danger{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un danger {{WebExtAPIRef('downloads.DownloadItem')}}.
+
mime{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un mime {{WebExtAPIRef('downloads.DownloadItem')}}
+
startTime{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un startTime {{WebExtAPIRef('downloads.DownloadItem')}}.
+
endTime{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un  endTime {{WebExtAPIRef('downloads.DownloadItem')}}.
+
state{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un état {{WebExtAPIRef('downloads.DownloadItem')}}
+
canResume{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} décrivant un changement dans un état {{WebExtAPIRef('downloads.DownloadItem')}} canResume.
+
paused{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} décrivant un changement dans un état en pause {{WebExtAPIRef('downloads.DownloadItem')}}.
+
error{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.StringDelta')}} décrivant un changement dans un état d'erreur {{WebExtAPIRef('downloads.DownloadItem')}}.
+
totalBytes{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.DoubleDelta')}} décrivant un changement dans un totalBytes {{WebExtAPIRef('downloads.DownloadItem')}}.
+
fileSize{{optional_inline}}
+
Un objet  {{WebExtAPIRef('downloads.DoubleDelta')}} décrivant une modification d'un  fileSize {{WebExtAPIRef('downloads.DownloadItem')}}.
+
exists{{optional_inline}}
+
Un objet {{WebExtAPIRef('downloads.BooleanDelta')}} décrivant un changement dans un état {{WebExtAPIRef('downloads.DownloadItem')}}.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Enregistrez un message lorsque les téléchargements sont terminés :

+ +
function handleChanged(delta) {
+  if (delta.state && delta.state.current === "complete") {
+    console.log(`Download ${delta.id} has completed.`);
+  }
+}
+
+browser.downloads.onChanged.addListener(handleChanged);
+ +

{{WebExtExamples}}

+ +

Note :

+ +

This API is based on Chromium's chrome.downloads API.

+ +

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.html deleted file mode 100644 index 5039805f8c..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: downloads.onCreated -slug: Mozilla/Add-ons/WebExtensions/API/downloads/onCreated -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - downlaods - - onCreated -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onCreated ---- -
{{AddonSidebar()}}
- -

L'événement onCreated() de l'API {{WebExtAPIRef("downloads")}} se déclenche lorsqu'un téléchargement commence, c'est à dire lorsque quand {{WebExtAPIRef("downloads.download()")}} est appelé avec succès.

- -

L'écouteur reçoit l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question en tant que paramètre.

- -

Syntaxe

- -
browser.downloads.onCreated.addListener(listener)
-browser.downloads.onCreated.removeListener(listener)
-browser.downloads.onCreated.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajoute un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
-
hasListener(listener)
-
Vérifiez si un listener donné est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
-
- -

Syntaxe addListener

- -

Paramètres

- -
-
function
-
-

Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants :

- -
-
downloadItem
-
L'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question.
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Consignez l'URL des éléments au fur et à mesure qu'ils sont téléchargés :

- -
function handleCreated(item) {
-  console.log(item.url);
-}
-
-browser.downloads.onCreated.addListener(handleCreated);
- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md new file mode 100644 index 0000000000..5039805f8c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md @@ -0,0 +1,108 @@ +--- +title: downloads.onCreated +slug: Mozilla/Add-ons/WebExtensions/API/downloads/onCreated +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - downlaods + - onCreated +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onCreated +--- +
{{AddonSidebar()}}
+ +

L'événement onCreated() de l'API {{WebExtAPIRef("downloads")}} se déclenche lorsqu'un téléchargement commence, c'est à dire lorsque quand {{WebExtAPIRef("downloads.download()")}} est appelé avec succès.

+ +

L'écouteur reçoit l'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question en tant que paramètre.

+ +

Syntaxe

+ +
browser.downloads.onCreated.addListener(listener)
+browser.downloads.onCreated.removeListener(listener)
+browser.downloads.onCreated.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoute un écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer.
+
hasListener(listener)
+
Vérifiez si un listener donné est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
+
+ +

Syntaxe addListener

+ +

Paramètres

+ +
+
function
+
+

Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants :

+ +
+
downloadItem
+
L'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question.
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Consignez l'URL des éléments au fur et à mesure qu'ils sont téléchargés :

+ +
function handleCreated(item) {
+  console.log(item.url);
+}
+
+browser.downloads.onCreated.addListener(handleCreated);
+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.html deleted file mode 100644 index dd6619721b..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.html +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: downloads.onErased -slug: Mozilla/Add-ons/WebExtensions/API/downloads/onErased -tags: - - API - - Add-ons - - Event - - Extensions - - Non-standard - - Reference - - WebExtensions - - downloads - - onErased -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onErased ---- -
{{AddonSidebar()}}
- -

L'événement onErased() de l'API {{WebExtAPIRef("downloads")}} se déclenche lorsqu'un téléchargement est effacé de l'historique du navigateur.

- -

L'écouteur reçoit le paramètre downloadId de l'objet {{WebExtAPIRef('downloads.DownloadItem')}}  en question en tant que paramètre.

- -

Syntaxe

- -
browser.downloads.onErased.addListener(listener)
-browser.downloads.onErased.removeListener(listener)
-browser.downloads.onErased.hasListener(listener)
-
- -

Les événements ont trois fonctions :

- -
-
addListener(callback)
-
Ajoute un écouteur à cet événement.
-
removeListener(listener)
-
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer..
-
hasListener(listener)
-
Vérifie si un listener donné est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
-
- -

syntaxe addListener

- -

Paramètres

- -
-
callback
-
-

Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants :

- -
-
downloadId
-
Un integer représentant l'id du {{WebExtAPIRef('downloads.DownloadItem')}} qui a été effacé.
-
-
-
- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Ajoute un écouteur pour les événements onErased , puis effacez le téléchargement le plus récent :

- -
function handleErased(item) {
-  console.log(`Erased: ${item}`);
-}
-
-browser.downloads.onErased.addListener(handleErased);
-
-var erasing = browser.downloads.erase({
-  limit: 1,
-  orderBy: ["-startTime"]
-});
- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md new file mode 100644 index 0000000000..dd6619721b --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md @@ -0,0 +1,113 @@ +--- +title: downloads.onErased +slug: Mozilla/Add-ons/WebExtensions/API/downloads/onErased +tags: + - API + - Add-ons + - Event + - Extensions + - Non-standard + - Reference + - WebExtensions + - downloads + - onErased +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onErased +--- +
{{AddonSidebar()}}
+ +

L'événement onErased() de l'API {{WebExtAPIRef("downloads")}} se déclenche lorsqu'un téléchargement est effacé de l'historique du navigateur.

+ +

L'écouteur reçoit le paramètre downloadId de l'objet {{WebExtAPIRef('downloads.DownloadItem')}}  en question en tant que paramètre.

+ +

Syntaxe

+ +
browser.downloads.onErased.addListener(listener)
+browser.downloads.onErased.removeListener(listener)
+browser.downloads.onErased.hasListener(listener)
+
+ +

Les événements ont trois fonctions :

+ +
+
addListener(callback)
+
Ajoute un écouteur à cet événement.
+
removeListener(listener)
+
Arrêtez d'écouter cet événement. L'argument listener est l'écouteur à supprimer..
+
hasListener(listener)
+
Vérifie si un listener donné est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.
+
+ +

syntaxe addListener

+ +

Paramètres

+ +
+
callback
+
+

Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants :

+ +
+
downloadId
+
Un integer représentant l'id du {{WebExtAPIRef('downloads.DownloadItem')}} qui a été effacé.
+
+
+
+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Ajoute un écouteur pour les événements onErased , puis effacez le téléchargement le plus récent :

+ +
function handleErased(item) {
+  console.log(`Erased: ${item}`);
+}
+
+browser.downloads.onErased.addListener(handleErased);
+
+var erasing = browser.downloads.erase({
+  limit: 1,
+  orderBy: ["-startTime"]
+});
+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.html deleted file mode 100644 index 336cacc837..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: downloads.open() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/open -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads - - open -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/open ---- -
{{AddonSidebar()}}
- -

La fonction open() de l'API {{WebExtAPIRef("downloads")}} ouvre le fichier téléchargé avec son application associée. Un événement {{WebExtAPIRef("downloads.onChanged")}} se déclenche lorsque l'élément est ouvert pour la première fois.

- -

Pour utiliser cette fonction dans votre extension, vous devez demander la permission manifest "downloads.open", ainsi que la permission "downloads". En outre, vous pouvez uniquement appeler cette fonction à l'intérieur du gestionnaire pour une action utilisateur.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var opening = browser.downloads.open(
-  downloadId      // integer
-)
-
- -

Paramètres

- -
-
downloadId
-
Un integer représentant l'id du {{WebExtAPIRef("downloads.DownloadItem")}} que vous voulez ouvrir.
-
- -

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

- -

Exemples

- -

Cet exemple ouvre l'élément le plus récemment téléchargé :

- -
function onOpened() {
-  console.log(`Opened download item`);
-}
-
-function onError(error) {
-  console.log(`Error opening item: ${error}`);
-}
-
-function openDownload(downloadItems) {
-    if (downloadItems.length > 0) {
-      var opening = browser.downloads.open(downloadItems[0].id);
-      opening.then(onOpened, onError);
-    }
-  }
-
-var searching = browser.downloads.search({
-  limit: 1,
-  orderBy: ["-startTime"]
-});
-
-searching.then(openDownload, 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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md new file mode 100644 index 0000000000..336cacc837 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md @@ -0,0 +1,110 @@ +--- +title: downloads.open() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/open +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - open +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/open +--- +
{{AddonSidebar()}}
+ +

La fonction open() de l'API {{WebExtAPIRef("downloads")}} ouvre le fichier téléchargé avec son application associée. Un événement {{WebExtAPIRef("downloads.onChanged")}} se déclenche lorsque l'élément est ouvert pour la première fois.

+ +

Pour utiliser cette fonction dans votre extension, vous devez demander la permission manifest "downloads.open", ainsi que la permission "downloads". En outre, vous pouvez uniquement appeler cette fonction à l'intérieur du gestionnaire pour une action utilisateur.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var opening = browser.downloads.open(
+  downloadId      // integer
+)
+
+ +

Paramètres

+ +
+
downloadId
+
Un integer représentant l'id du {{WebExtAPIRef("downloads.DownloadItem")}} que vous voulez ouvrir.
+
+ +

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

+ +

Exemples

+ +

Cet exemple ouvre l'élément le plus récemment téléchargé :

+ +
function onOpened() {
+  console.log(`Opened download item`);
+}
+
+function onError(error) {
+  console.log(`Error opening item: ${error}`);
+}
+
+function openDownload(downloadItems) {
+    if (downloadItems.length > 0) {
+      var opening = browser.downloads.open(downloadItems[0].id);
+      opening.then(onOpened, onError);
+    }
+  }
+
+var searching = browser.downloads.search({
+  limit: 1,
+  orderBy: ["-startTime"]
+});
+
+searching.then(openDownload, 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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.html deleted file mode 100644 index 2a72e562eb..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.html +++ /dev/null @@ -1,94 +0,0 @@ ---- -title: downloads.pause() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/pause -tags: - - API - - Add-ons - - Extensions - - Method - - Non-standard - - Reference - - WebExtensions - - downloads - - pause -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/pause ---- -
{{AddonSidebar()}}
- -

La fonction pause() de l'API {{WebExtAPIRef("downloads")}} interrompt un téléchargement.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var pausing = browser.downloads.pause(
-  downloadId      // integer
-)
-
- -

Paramètres

- -
-
downloadId
-
Un integer représetant l'id du téléchargement à mettre en pause.
-
- -

Valeur retournée

- -

Une Promise. Si l'appel a réussi, le téléchargement sera mis en pause et la promesse sera satisfaite sans aucun argument. Si l'appel échoue, la promesse sera rejetée avec un message d'erreur. L'appel échouera si le téléchargement n'est pas actif: par exemple, parce qu'il a fini le téléchargement.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -
function onPaused() {
-  console.log(`Paused download`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var pausing = browser.downloads.pause(downloadId);
-pausing.then(onPaused, 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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md new file mode 100644 index 0000000000..2a72e562eb --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md @@ -0,0 +1,94 @@ +--- +title: downloads.pause() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/pause +tags: + - API + - Add-ons + - Extensions + - Method + - Non-standard + - Reference + - WebExtensions + - downloads + - pause +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/pause +--- +
{{AddonSidebar()}}
+ +

La fonction pause() de l'API {{WebExtAPIRef("downloads")}} interrompt un téléchargement.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var pausing = browser.downloads.pause(
+  downloadId      // integer
+)
+
+ +

Paramètres

+ +
+
downloadId
+
Un integer représetant l'id du téléchargement à mettre en pause.
+
+ +

Valeur retournée

+ +

Une Promise. Si l'appel a réussi, le téléchargement sera mis en pause et la promesse sera satisfaite sans aucun argument. Si l'appel échoue, la promesse sera rejetée avec un message d'erreur. L'appel échouera si le téléchargement n'est pas actif: par exemple, parce qu'il a fini le téléchargement.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +
function onPaused() {
+  console.log(`Paused download`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var pausing = browser.downloads.pause(downloadId);
+pausing.then(onPaused, 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.

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

-
- - 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 new file mode 100644 index 0000000000..4bc3a2a440 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md @@ -0,0 +1,116 @@ +--- +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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.html deleted file mode 100644 index 61ff022edf..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: downloads.resume() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/resume -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads - - resume -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/resume ---- -
{{AddonSidebar()}}
- -

La fonction resume() de l'API {{WebExtAPIRef("downloads")}} reprend un téléchargement suspendu. Si la demande a abouti, le téléchargement ne sera pas interrompu et la progression reprendra. L'appel resume() échouera si le téléchargement n'est pas actif: par exemple, parce qu'il a fini le téléchargement.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var resuming = browser.downloads.resume(
-  downloadId      // integer
-)
-
- -

Paramètres

- -
-
downloadId
-
Un integer représentant l'id du téléchargement à reprendre.
-
- -

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

- -

Exemples

- -
var downloadId = 2;
-
-function onResumed() {
-  console.log(`Resumed download`);
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var resuming = browser.downloads.resume(downloadId);
-resuming.then(onResumed, 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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md new file mode 100644 index 0000000000..61ff022edf --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md @@ -0,0 +1,97 @@ +--- +title: downloads.resume() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/resume +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - resume +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/resume +--- +
{{AddonSidebar()}}
+ +

La fonction resume() de l'API {{WebExtAPIRef("downloads")}} reprend un téléchargement suspendu. Si la demande a abouti, le téléchargement ne sera pas interrompu et la progression reprendra. L'appel resume() échouera si le téléchargement n'est pas actif: par exemple, parce qu'il a fini le téléchargement.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var resuming = browser.downloads.resume(
+  downloadId      // integer
+)
+
+ +

Paramètres

+ +
+
downloadId
+
Un integer représentant l'id du téléchargement à reprendre.
+
+ +

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

+ +

Exemples

+ +
var downloadId = 2;
+
+function onResumed() {
+  console.log(`Resumed download`);
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var resuming = browser.downloads.resume(downloadId);
+resuming.then(onResumed, 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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.html deleted file mode 100644 index 5f7fa9d84c..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.html +++ /dev/null @@ -1,166 +0,0 @@ ---- -title: downloads.search() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/search -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Recherche - - Reference - - Search - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/search ---- -
{{AddonSidebar()}}
- -

La fonction search() de l'API {{WebExtAPIRef("downloads")}} interroge les {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponibles dans le gestionnaire de téléchargements du navigateur, et renvoie celles qui correspondent aux spécifications critères de recherche.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var searching = browser.downloads.search(query);
-
- -

Paramètres

- -
-
query
-
Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.
-
- -

Return value

- -

Une Promise. La promise est remplie avec un tableau d'objets {{WebExtAPIRef('downloads.DownloadItem')}} qui correspondent aux critères donnés.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

En général, vous restreignez les éléments récupérés à l'aide du paramètre de requête.

- -

Obtenez les téléchargements correspondant à "query"

- -
function logDownloads(downloads) {
-  for (let download of downloads) {
-    console.log(download.id);
-    console.log(download.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var searching = browser.downloads.search({
-  query:["imgur"]
-});
-
-searching.then(logDownloads, onError);
- -

Obtenez un article spécifique

- -

Pour obtenir un {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, la méthode la plus simple consiste à définir uniquement le champ id, comme indiqué dans l'extrait ci-dessous :

- -
function logDownloads(downloads) {
-  for (let download of downloads) {
-    console.log(download.id);
-    console.log(download.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var id = 13;
-
-var searching = browser.downloads.search({id});
-searching.then(logDownloads, onError);
-
- -

Obtenez tous les téléchargements

- -

Si vous voulez renvoyer tout {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}, définissez la query sur un objet vide.

- -
function logDownloads(downloads) {
-  for (let download of downloads) {
-    console.log(download.id);
-    console.log(download.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var searching = browser.downloads.search({});
-searching.then(logDownloads, onError);
- -

Obtenez le téléchargement le plus récent

- -

Vous pouvez obtenir le téléchargement le plus récent en spécifiant les paramètres de recherche suivants :

- -
function logDownloads(downloads) {
-  for (let download of downloads) {
-    console.log(download.id);
-    console.log(download.url);
-  }
-}
-
-function onError(error) {
-  console.log(`Error: ${error}`);
-}
-
-var searching = browser.downloads.search({
-   limit: 1,
-   orderBy: ["-startTime"]
-});
-searching.then(logDownloads, onError);
- -

Vous pouvez voir ce code en action par exemple dans notre dernier téléchargement.

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md new file mode 100644 index 0000000000..5f7fa9d84c --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md @@ -0,0 +1,166 @@ +--- +title: downloads.search() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/search +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Recherche + - Reference + - Search + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/search +--- +
{{AddonSidebar()}}
+ +

La fonction search() de l'API {{WebExtAPIRef("downloads")}} interroge les {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}} disponibles dans le gestionnaire de téléchargements du navigateur, et renvoie celles qui correspondent aux spécifications critères de recherche.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var searching = browser.downloads.search(query);
+
+ +

Paramètres

+ +
+
query
+
Un objet {{WebExtAPIRef('downloads.DownloadQuery')}}.
+
+ +

Return value

+ +

Une Promise. La promise est remplie avec un tableau d'objets {{WebExtAPIRef('downloads.DownloadItem')}} qui correspondent aux critères donnés.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

En général, vous restreignez les éléments récupérés à l'aide du paramètre de requête.

+ +

Obtenez les téléchargements correspondant à "query"

+ +
function logDownloads(downloads) {
+  for (let download of downloads) {
+    console.log(download.id);
+    console.log(download.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var searching = browser.downloads.search({
+  query:["imgur"]
+});
+
+searching.then(logDownloads, onError);
+ +

Obtenez un article spécifique

+ +

Pour obtenir un {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}}, la méthode la plus simple consiste à définir uniquement le champ id, comme indiqué dans l'extrait ci-dessous :

+ +
function logDownloads(downloads) {
+  for (let download of downloads) {
+    console.log(download.id);
+    console.log(download.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var id = 13;
+
+var searching = browser.downloads.search({id});
+searching.then(logDownloads, onError);
+
+ +

Obtenez tous les téléchargements

+ +

Si vous voulez renvoyer tout {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}, définissez la query sur un objet vide.

+ +
function logDownloads(downloads) {
+  for (let download of downloads) {
+    console.log(download.id);
+    console.log(download.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var searching = browser.downloads.search({});
+searching.then(logDownloads, onError);
+ +

Obtenez le téléchargement le plus récent

+ +

Vous pouvez obtenir le téléchargement le plus récent en spécifiant les paramètres de recherche suivants :

+ +
function logDownloads(downloads) {
+  for (let download of downloads) {
+    console.log(download.id);
+    console.log(download.url);
+  }
+}
+
+function onError(error) {
+  console.log(`Error: ${error}`);
+}
+
+var searching = browser.downloads.search({
+   limit: 1,
+   orderBy: ["-startTime"]
+});
+searching.then(logDownloads, onError);
+ +

Vous pouvez voir ce code en action par exemple dans notre dernier téléchargement.

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.html deleted file mode 100644 index e3a1a60755..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: downloads.setShelfEnabled() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads - - setShelfEnabled -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled ---- -

{{AddonSidebar()}}

- -

La fonction  setShelfEnabled() de l'API {{WebExtAPIRef("downloads")}} active ou désactive l'étagère grise située en bas de chaque fenêtre associée au profil de navigateur actuel. L'étagère sera désactivée si au moins une extension l'a désactivée.

- -

Si vous essayez d'activer l'étagère lorsqu'au moins une autre extension l'a déjà désactivé, l'appel échouera et {{WebExtAPIRef("runtime.lastError")}} sera défini avec un message d'erreur approprié.

- -
-

Note : Pour utiliser cette fonction dans votre extension, vous devez demander la permission manifest, "downloads.shelf", ainsi que la permission "downloads".

-
- -

Syntaxe

- -
chrome.downloads.setShelfEnabled(enabled);
-
- -

Cette API est également disponible en tant que  browser.downloads.setShelfEnabled().

- -

Paramètres

- -
-
enabled
-
Un boolean l'état que vous souhaitez définir setShelfEnabled() à — true pour activer et false pour désactiver.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md new file mode 100644 index 0000000000..e3a1a60755 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md @@ -0,0 +1,82 @@ +--- +title: downloads.setShelfEnabled() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - setShelfEnabled +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled +--- +

{{AddonSidebar()}}

+ +

La fonction  setShelfEnabled() de l'API {{WebExtAPIRef("downloads")}} active ou désactive l'étagère grise située en bas de chaque fenêtre associée au profil de navigateur actuel. L'étagère sera désactivée si au moins une extension l'a désactivée.

+ +

Si vous essayez d'activer l'étagère lorsqu'au moins une autre extension l'a déjà désactivé, l'appel échouera et {{WebExtAPIRef("runtime.lastError")}} sera défini avec un message d'erreur approprié.

+ +
+

Note : Pour utiliser cette fonction dans votre extension, vous devez demander la permission manifest, "downloads.shelf", ainsi que la permission "downloads".

+
+ +

Syntaxe

+ +
chrome.downloads.setShelfEnabled(enabled);
+
+ +

Cette API est également disponible en tant que  browser.downloads.setShelfEnabled().

+ +

Paramètres

+ +
+
enabled
+
Un boolean l'état que vous souhaitez définir setShelfEnabled() à — true pour activer et false pour désactiver.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.html deleted file mode 100644 index 6e995496ef..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: downloads.show() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/show -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Reference - - WebExtensions - - downloads - - show -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/show ---- -
{{AddonSidebar()}}
- -

La fonction show() de l'API {{WebExtAPIRef("downloads")}} affiche le fichier téléchargé dans son dossier contenant dans le gestionnaire de fichiers de la plate-forme sous-jacente.

- -

C'est une fonction asynchrone qui renvoie une Promise.

- -

Syntaxe

- -
var showing = browser.downloads.show(
-  downloadId             // integer
-)
-
- -

Paramètes

- -
-
downloadId
-
Un integer représentant l'ID du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} à afficher.
-
- -

Valeur retournée

- -

Une Promise. Si la demande est acceptée, la promise sera remplie avec un booléen indiquant si la demande a été acceptée. Si la demande échoue, la promise sera rejetée avec un message d'erreur.

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

Cet exemple montre l'élément le plus récemment téléchargé :

- -
function onShowing(success) {
-  console.log(`Showing download item: ${success}`);
-}
-
-function onError(error) {
-  console.log(`Error opening item: ${error}`);
-}
-
-function openDownload(downloadItems) {
-    if (downloadItems.length > 0) {
-      latestDownloadId = downloadItems[0].id;
-      var showing = browser.downloads.show(latestDownloadId);
-      showing.then(onShowing, onError);
-    }
-  }
-
-var searching = browser.downloads.search({
-  limit: 1,
-  orderBy: ["-startTime"]
-});
-
-searching.then(openDownload, 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.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md new file mode 100644 index 0000000000..6e995496ef --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md @@ -0,0 +1,109 @@ +--- +title: downloads.show() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/show +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Reference + - WebExtensions + - downloads + - show +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/show +--- +
{{AddonSidebar()}}
+ +

La fonction show() de l'API {{WebExtAPIRef("downloads")}} affiche le fichier téléchargé dans son dossier contenant dans le gestionnaire de fichiers de la plate-forme sous-jacente.

+ +

C'est une fonction asynchrone qui renvoie une Promise.

+ +

Syntaxe

+ +
var showing = browser.downloads.show(
+  downloadId             // integer
+)
+
+ +

Paramètes

+ +
+
downloadId
+
Un integer représentant l'ID du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} à afficher.
+
+ +

Valeur retournée

+ +

Une Promise. Si la demande est acceptée, la promise sera remplie avec un booléen indiquant si la demande a été acceptée. Si la demande échoue, la promise sera rejetée avec un message d'erreur.

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

Cet exemple montre l'élément le plus récemment téléchargé :

+ +
function onShowing(success) {
+  console.log(`Showing download item: ${success}`);
+}
+
+function onError(error) {
+  console.log(`Error opening item: ${error}`);
+}
+
+function openDownload(downloadItems) {
+    if (downloadItems.length > 0) {
+      latestDownloadId = downloadItems[0].id;
+      var showing = browser.downloads.show(latestDownloadId);
+      showing.then(onShowing, onError);
+    }
+  }
+
+var searching = browser.downloads.search({
+  limit: 1,
+  orderBy: ["-startTime"]
+});
+
+searching.then(openDownload, 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.

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.html deleted file mode 100644 index 110f2e13a7..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: downloads.showDefaultFolder() -slug: Mozilla/Add-ons/WebExtensions/API/downloads/showDefaultFolder -tags: - - API - - Add-ons - - Extensions - - Méthode - - Non-standard - - Refernce - - ShwoDefaultFolder - - Téléchargement - - WebExtensions - - downloads -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/showDefaultFolder ---- -
{{AddonSidebar()}}
- -

La fonction showDefaultFolder() de l'API {{WebExtAPIRef("downloads")}} ouvre le dossier de téléchargement par défaut dans le gestionnaire de fichiers de la plateforme.

- -

Syntaxe

- -
browser.downloads.showDefaultFolder();
-
- -

Paramètres

-

Aucun

- -

Compatibilité du navigateur

- -

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

- -

Exemples

- -

L'extrait suivant contient un bouton d'affichage qui, lorsqu'il est cliqué, appelle showDefaultFolder() pour ouvrir le dossier de téléchargement par défaut dans le gestionnaire de fichiers de la plateforme :

- -
var showBtn = document.querySelector('.show');
-
-showBtn.onclick = function() {
-  browser.downloads.showDefaultFolder();
-}
- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md new file mode 100644 index 0000000000..110f2e13a7 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md @@ -0,0 +1,81 @@ +--- +title: downloads.showDefaultFolder() +slug: Mozilla/Add-ons/WebExtensions/API/downloads/showDefaultFolder +tags: + - API + - Add-ons + - Extensions + - Méthode + - Non-standard + - Refernce + - ShwoDefaultFolder + - Téléchargement + - WebExtensions + - downloads +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/showDefaultFolder +--- +
{{AddonSidebar()}}
+ +

La fonction showDefaultFolder() de l'API {{WebExtAPIRef("downloads")}} ouvre le dossier de téléchargement par défaut dans le gestionnaire de fichiers de la plateforme.

+ +

Syntaxe

+ +
browser.downloads.showDefaultFolder();
+
+ +

Paramètres

+

Aucun

+ +

Compatibilité du navigateur

+ +

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

+ +

Exemples

+ +

L'extrait suivant contient un bouton d'affichage qui, lorsqu'il est cliqué, appelle showDefaultFolder() pour ouvrir le dossier de téléchargement par défaut dans le gestionnaire de fichiers de la plateforme :

+ +
var showBtn = document.querySelector('.show');
+
+showBtn.onclick = function() {
+  browser.downloads.showDefaultFolder();
+}
+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.html deleted file mode 100644 index e266b1a584..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: downloads.State -slug: Mozilla/Add-ons/WebExtensions/API/downloads/State -tags: - - API - - Add-ons - - Extensions - - Non-standard - - Reference - - Type - - WebExtensions - - downloads - - state -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/State ---- -

{{AddonSidebar()}}

- -

Le type d'état de l'API {{WebExtAPIRef("downloads")}} définit différents états dans lesquels un téléchargement en cours peut se trouver.

- -

Une propriété d'state {{WebExtAPIRef('downloads.DownloadItem')}}  contiendra une chaîne tirée des valeurs définies dans ce type.

- -

Type

- -

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

- -
-
in_progress
-
Le navigateur reçoit actuellement les données de téléchargement du serveur .
-
interrupted
-
Une erreur a rompu la connexion avec le serveur.
-
complete
-
Le téléchargement s'est terminé avec succès.
-
- -
-

Note : Ces constantes de chaîne ne changeront jamais, mais de nouvelles constantes peuvent être ajoutées.

-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md new file mode 100644 index 0000000000..e266b1a584 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md @@ -0,0 +1,81 @@ +--- +title: downloads.State +slug: Mozilla/Add-ons/WebExtensions/API/downloads/State +tags: + - API + - Add-ons + - Extensions + - Non-standard + - Reference + - Type + - WebExtensions + - downloads + - state +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/State +--- +

{{AddonSidebar()}}

+ +

Le type d'état de l'API {{WebExtAPIRef("downloads")}} définit différents états dans lesquels un téléchargement en cours peut se trouver.

+ +

Une propriété d'state {{WebExtAPIRef('downloads.DownloadItem')}}  contiendra une chaîne tirée des valeurs définies dans ce type.

+ +

Type

+ +

Les valeurs de ce type sont des chaînes. Les valeurs possibles sont :

+ +
+
in_progress
+
Le navigateur reçoit actuellement les données de téléchargement du serveur .
+
interrupted
+
Une erreur a rompu la connexion avec le serveur.
+
complete
+
Le téléchargement s'est terminé avec succès.
+
+ +
+

Note : Ces constantes de chaîne ne changeront jamais, mais de nouvelles constantes peuvent être ajoutées.

+
+ +

Compatibilité du navigateur

+ +

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

+ +

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

+
+ + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.html b/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.html deleted file mode 100644 index 793fcafab1..0000000000 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.html +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: downloads.StringDelta -slug: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta -tags: - - API - - Add-ons - - Extensions - - Reference - - StringDelta - - Type - - Téléchargement - - WebExtensions - - download -translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta ---- -
{{AddonSidebar()}}
- -

Le type StringDelta de l'API {{WebExtAPIRef("downloads")}} représente la différence entre deux chaînes.

- -

Type

- -

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes:

- -
-
current{{optional_inline}}
-
Un string représentant la valeur de chaîne actuelle.
-
previous{{optional_inline}}
-
Un string représentant la valeur de chaîne précédente.
-
- -

Compatibilité du navigateur

- -

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

- -

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

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md new file mode 100644 index 0000000000..793fcafab1 --- /dev/null +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md @@ -0,0 +1,73 @@ +--- +title: downloads.StringDelta +slug: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta +tags: + - API + - Add-ons + - Extensions + - Reference + - StringDelta + - Type + - Téléchargement + - WebExtensions + - download +translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta +--- +
{{AddonSidebar()}}
+ +

Le type StringDelta de l'API {{WebExtAPIRef("downloads")}} représente la différence entre deux chaînes.

+ +

Type

+ +

Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes:

+ +
+
current{{optional_inline}}
+
Un string représentant la valeur de chaîne actuelle.
+
previous{{optional_inline}}
+
Un string représentant la valeur de chaîne précédente.
+
+ +

Compatibilité du navigateur

+ +

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

+ +

{{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