From 3cf9bd8b9901006085d4e0f353b0d3b6b8f69d93 Mon Sep 17 00:00:00 2001 From: julieng Date: Mon, 15 Nov 2021 21:45:15 +0100 Subject: convert content to md --- .../api/downloads/acceptdanger/index.md | 50 +++--- .../api/downloads/booleandelta/index.md | 41 +++-- .../webextensions/api/downloads/cancel/index.md | 56 ++++--- .../api/downloads/dangertype/index.md | 71 ++++----- .../api/downloads/doubledelta/index.md | 41 +++-- .../webextensions/api/downloads/download/index.md | 147 ++++++++--------- .../api/downloads/downloaditem/index.md | 113 +++++++------ .../api/downloads/downloadquery/index.md | 135 ++++++++-------- .../api/downloads/downloadtime/index.md | 44 +++-- .../webextensions/api/downloads/drag/index.md | 44 +++-- .../webextensions/api/downloads/erase/index.md | 72 ++++----- .../api/downloads/filenameconflictaction/index.md | 47 +++--- .../api/downloads/getfileicon/index.md | 77 +++++---- .../add-ons/webextensions/api/downloads/index.md | 149 ++++++++--------- .../api/downloads/interruptreason/index.md | 101 +++++------- .../webextensions/api/downloads/onchanged/index.md | 177 ++++++++++----------- .../webextensions/api/downloads/oncreated/index.md | 81 +++++----- .../webextensions/api/downloads/onerased/index.md | 81 +++++----- .../webextensions/api/downloads/open/index.md | 62 ++++---- .../webextensions/api/downloads/pause/index.md | 56 ++++--- .../api/downloads/removefile/index.md | 68 ++++---- .../webextensions/api/downloads/resume/index.md | 56 ++++--- .../webextensions/api/downloads/search/index.md | 91 ++++++----- .../api/downloads/setshelfenabled/index.md | 50 +++--- .../webextensions/api/downloads/show/index.md | 60 ++++--- .../api/downloads/showdefaultfolder/index.md | 49 +++--- .../webextensions/api/downloads/state/index.md | 51 +++--- .../api/downloads/stringdelta/index.md | 41 +++-- 28 files changed, 990 insertions(+), 1121 deletions(-) (limited to 'files/fr/mozilla/add-ons/webextensions/api/downloads') 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 index fe7a263f39..8a913b26b7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/acceptdanger/index.md @@ -13,47 +13,44 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/acceptDanger --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

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

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

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

Parameters

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

Valeur retournée

+### Valeur retournée -

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

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Lorsque la boîte de dialogue se ferme, la promesse sera remplie sans arguments. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 43edabfce3..a19cbd5971 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/booleandelta/index.md @@ -13,36 +13,32 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/BooleanDelta --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

Type

+## Type -

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

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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 5a2bb1d7e9..40e8e525c4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/cancel/index.md @@ -15,37 +15,37 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/cancel --- -
{{AddonSidebar()}}
+{{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..

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

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

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

Paramètres

+### Paramètres -
-
downloadId
-
integer. L'identifiant du téléchargement à annuler.
-
+- `downloadId` + - : `integer`. L'identifiant du téléchargement à annuler. -

Valeur retournée

+### Valeur retournée -

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

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a été acceptée, la promesse sera remplie sans arguments. Si la demande a échoué, la promesse sera rejetée avec un message d'erreur. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -
var downloadId = 13;
+```js
+var downloadId = 13;
 
 function onCanceled() {
   console.log(`Canceled download`);
@@ -56,19 +56,18 @@ function onError(error) {
 }
 
 var canceling = browser.downloads.cancel(downloadId);
-canceling.then(onCanceled, onError);
+canceling.then(onCanceled, onError); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + 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 index 7f96700ba8..4d11d5cef9 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/dangertype/index.md @@ -13,54 +13,48 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DangerType --- -

{{AddonSidebar()}}

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

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

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

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

Type

+## Type -

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

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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 6dde623ac5..fa53d48233 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/doubledelta/index.md @@ -13,36 +13,32 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DoubleDelta --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

Type

+## Type -

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

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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index ff6364769b..2450697eb6 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/download/index.md @@ -13,80 +13,75 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/download --- -
{{AddonSidebar()}}
+{{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.

+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. - +- Si l'`url` spécifiée utilise le protocole HTTP ou HTTPS, la requête inclura tous les cookies actuellement définis pour son nom d'hôte. +- Si à la fois le  `nom de fichier` et `saveAs` sont spécifiés, la boîte de dialogue Enregistrer sous s'affiche, pré-remplie avec le `nom du fichier` spécifié. -

C'est une fonction asynchrone qui renvoie une Promise.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

+## Syntaxe -
var downloading = browser.downloads.download(
+```js
+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) {
+```
+
+### 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`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/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()](/fr/docs/Web/API/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](/fr/docs/Web/API/URL/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](/fr/Add-ons/WebExtensions/API/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`.
+
+```js
+function onStartedDownload(id) {
   console.log(`Started downloading: ${id}`);
 }
 
@@ -102,17 +97,16 @@ var downloading = browser.downloads.download({
   conflictAction : 'uniquify'
 });
 
-downloading.then(onStartedDownload, onFailed);
- -

{{WebExtExamples}}

+downloading.then(onStartedDownload, onFailed); +``` -

Note :

+{{WebExtExamples}} -

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

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). - + 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 index 98fcbe438f..4d81c6642d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloaditem/index.md @@ -13,72 +13,68 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadItem --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

Type

+## Type -

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

+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é.
-
+- `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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 8e3071fb70..3f671d1cec 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadquery/index.md @@ -12,84 +12,80 @@ tags: - WebExtensions translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadQuery --- -
{{AddonSidebar()}}
+{{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.

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

+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

+## Type -

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

+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.
-
+- `query`{{optional_inline}} + - : Un `tableau` de`chaines`. 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 `tableau`de `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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index a956cd5a93..358723fe58 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/downloadtime/index.md @@ -13,40 +13,35 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/DownloadTime --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

Type

+## Type -

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

+Un `DownloadTime` peut être l'un de trois types différents : - +- Un objet JavaScript [`Date`](/fr/docs/Web/JavaScript/Reference/Global_Objects/Date). +- a string: -

Compatibilité du navigateur

+ - Si cela ne contient que des chiffres, il est interprété comme le nombre de millisecondes écoulées depuis l'époque UNI. + - inon, il est interprété comme une chaîne [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). -

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

+- un nombre : ceci est interprété comme le nombre de millisecondes écoulées depuis l'époque UNIX. -

{{WebExtExamples}}

+## Compatibilité du navigateur -

Note :

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

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

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. - 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 index 353f70f26a..deaa5eff4e 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/drag/index.md @@ -13,41 +13,38 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/drag --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

Syntaxe

+## Syntaxe -
chrome.downloads.drag(
+```js
+chrome.downloads.drag(
   downloadId // integer
 )
-
+``` -

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

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

Paramètres

+### Paramètres -
-
downloadId
-
Un integer représentant l'id du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} ein question.
-
+- `downloadId` + - : Un `integer` représentant l'`id` du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} ein question. -

Browser compatibility

+## Browser compatibility -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md index 44d9d1fe46..65e1a1cd10 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/erase/index.md @@ -14,45 +14,43 @@ tags: - erase translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/erase --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

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

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

C'est une fonction asynchrone qui renvoie une Promise.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -
-

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

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

Syntaxe

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

Paramètres

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

Valeur retournée

+### Valeur retournée -

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

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

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

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

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

Tout effacer :

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + 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 index 6d1c4c0709..e6ec407f0d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/filenameconflictaction/index.md @@ -13,40 +13,36 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/FilenameConflictAction --- -
{{AddonSidebar()}}
+{{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.

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

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

Type

+## Type -

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

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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 7fb93c5494..dda5a74a86 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/getfileicon/index.md @@ -13,51 +13,50 @@ tags: - getFileIcon translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/getFileIcon --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

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

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

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

+## Syntaxe -
var gettingIcon = browser.downloads.getFileIcon(
+```js
+var gettingIcon = browser.downloads.getFileIcon(
   downloadId,           // integer
   options               // optional object
 )
-
+``` -

Paramètres

+### 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.
-
-
-
+- `downloadId` + - : Un `integer` eprésentant l'ID du téléchargement. +- `options`{{optional_inline}} -

Valeur retournée

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

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.

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

Compatibilité du navigateur

+### Valeur retournée -

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

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

Exemples

+## Compatibilité du navigateur -

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

+{{Compat("webextensions.api.downloads.getFileIcon")}} -
function gotIcon(iconUrl) {
+## Exemples
+
+Cet exemple enregistre l'URL de l'icône pour le téléchargement le plus récent :
+
+```js
+function gotIcon(iconUrl) {
   console.log(iconUrl);
 }
 
@@ -66,7 +65,7 @@ function onError(error) {
 }
 
 function getIcon(downloadItems) {
-    if (downloadItems.length > 0) {
+    if (downloadItems.length > 0) {
       latestDownloadId = downloadItems[0].id;
       var gettingIcon = browser.downloads.getFileIcon(latestDownloadId);
       gettingIcon.then(gotIcon, onError);
@@ -78,19 +77,18 @@ var searching = browser.downloads.search({
   orderBy: ["-startTime"]
 });
 
-searching.then(getIcon, onError);
- -

{{WebExtExamples}}

- -

Note :

+searching.then(getIcon, onError); +``` -

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

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. - + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md index 3a5af5f188..1729e6029d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/index.md @@ -12,96 +12,88 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads --- -
{{AddonSidebar}}
+{{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.

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

+Pour utiliser cette API, vous devez disposer de l' [API permission](/fr/Add-ons/WebExtensions/manifest.json/permissions#API_permissions) "downloads" spécifiée dans votre fichier [manifest.json](/fr/Add-ons/WebExtensions/manifest.json). -

Types

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

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

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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples("h2")}}

+{{WebExtExamples("h2")}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index fa29a664f6..989176a3f8 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/interruptreason/index.md @@ -13,80 +13,68 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/InterruptReason --- -
{{AddonSidebar()}}
+{{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.

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

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

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:

+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 fichier : - +- `"FILE_FAILED"` +- `"FILE_ACCESS_DENIED"` +- `"FILE_NO_SPACE"` +- `"FILE_NAME_TOO_LONG"` +- `"FILE_TOO_LARGE"` +- `"FILE_VIRUS_INFECTED"` +- `"FILE_TRANSIENT_ERROR"` +- `"FILE_BLOCKED"` +- `"FILE_SECURITY_CHECK_FAILED"` +- `"FILE_TOO_SHORT"` -

Erreurs liées au réseau :

+Erreurs liées au réseau : - +- `"NETWORK_FAILED"` +- `"NETWORK_TIMEOUT"` +- `"NETWORK_DISCONNECTED"` +- `"NETWORK_SERVER_DOWN"` +- `"NETWORK_INVALID_REQUEST"` -

Erreurs liées au serveur :

+Erreurs liées au serveur : - +- `"SERVER_FAILED"` +- `"SERVER_NO_RANGE"` +- `"SERVER_BAD_CONTENT"` +- `"SERVER_UNAUTHORIZED"` +- `"SERVER_CERT_PROBLEM"` +- `"SERVER_FORBIDDEN"` -

Erreurs liées à l'utilisateur :

+Erreurs liées à l'utilisateur : - +- `"USER_CANCELED"` +- `"USER_SHUTDOWN"` -

Divers :

+Divers : - +- `"CRASH"` -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 5637ace775..5e1f262aac 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/onchanged/index.md @@ -14,110 +14,102 @@ tags: - onChanged translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onChanged --- -
{{AddonSidebar()}}
+{{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'é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é.

+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

+## Syntaxe -
browser.downloads.onChanged.addListener(listener)
+```js
+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") {
+```
+
+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`](#downloadDelta) 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 :
+
+```js
+function handleChanged(delta) {
+  if (delta.state && delta.state.current === "complete") {
     console.log(`Download ${delta.id} has completed.`);
   }
 }
 
-browser.downloads.onChanged.addListener(handleChanged);
+browser.downloads.onChanged.addListener(handleChanged); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> This API is based on Chromium's [`chrome.downloads`](https://developer.chrome.com/extensions/downloads#event-onChanged) API. +> +> Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License. -

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.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md index 5039805f8c..7b4740451d 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/oncreated/index.md @@ -13,71 +13,65 @@ tags: - onCreated translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onCreated --- -
{{AddonSidebar()}}
+{{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'é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.

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

Syntaxe

+## Syntaxe -
browser.downloads.onCreated.addListener(listener)
+```js
+browser.downloads.onCreated.addListener(listener)
 browser.downloads.onCreated.removeListener(listener)
 browser.downloads.onCreated.hasListener(listener)
-
+``` -

Les événements ont trois fonctions :

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

+## Syntaxe addListener -

Paramètres

+### Paramètres -
-
function
-
-

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

+- `function` -
-
downloadItem
-
L'objet {{WebExtAPIRef('downloads.DownloadItem')}} en question.
-
-
-
+ - : Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants : -

Compatibilité du navigateur

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

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

+## Compatibilité du navigateur -

Exemples

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

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

+## Exemples -
function handleCreated(item) {
+Consignez l'URL des éléments au fur et à mesure qu'ils sont téléchargés :
+
+```js
+function handleCreated(item) {
   console.log(item.url);
 }
 
-browser.downloads.onCreated.addListener(handleCreated);
- -

{{WebExtExamples}}

- -

Note :

+browser.downloads.onCreated.addListener(handleCreated); +``` -

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

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. - + 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 index dd6619721b..a9405d0c89 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/onerased/index.md @@ -13,55 +13,50 @@ tags: - onErased translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/onErased --- -
{{AddonSidebar()}}
+{{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'é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.

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

Syntaxe

+## Syntaxe -
browser.downloads.onErased.addListener(listener)
+```js
+browser.downloads.onErased.addListener(listener)
 browser.downloads.onErased.removeListener(listener)
 browser.downloads.onErased.hasListener(listener)
-
+``` -

Les événements ont trois fonctions :

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

+## syntaxe addListener -

Paramètres

+### Paramètres -
-
callback
-
-

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

+- `callback` -
-
downloadId
-
Un integer représentant l'id du {{WebExtAPIRef('downloads.DownloadItem')}} qui a été effacé.
-
-
-
+ - : Une fonction de rappel qui sera appelée lorsque cet événement se produira. Cette fonction recevra les arguments suivants : -

Compatibilité du navigateur

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

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

+## Compatibilité du navigateur -

Exemples

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

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

+## Exemples -
function handleErased(item) {
+Ajoute un écouteur pour les événements `onErased` , puis effacez le téléchargement le plus récent :
+
+```js
+function handleErased(item) {
   console.log(`Erased: ${item}`);
 }
 
@@ -70,19 +65,18 @@ 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.

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. - 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 index 336cacc837..bc3000bdef 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/open/index.md @@ -13,41 +13,41 @@ tags: - open translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/open --- -
{{AddonSidebar()}}
+{{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.

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

+Pour utiliser cette fonction dans votre extension, vous devez demander la [permission manifest](/fr/Add-ons/WebExtensions/manifest.json/permissions) "downloads.open", ainsi que la permission "downloads". En outre, vous pouvez uniquement appeler cette fonction à l'intérieur du gestionnaire pour une [action utilisateur](/fr/Add-ons/WebExtensions/User_actions). -

C'est une fonction asynchrone qui renvoie une Promise.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

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

Paramètres

+### Paramètres -
-
downloadId
-
Un integer représentant l'id du {{WebExtAPIRef("downloads.DownloadItem")}} que vous voulez ouvrir.
-
+- `downloadId` + - : Un `integer` représentant l'`id` du {{WebExtAPIRef("downloads.DownloadItem")}} que vous voulez ouvrir. -

Valeur retournée

+### Valeur retournée -

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

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a été acceptée, la promesse sera remplie sans arguments. Si la demande a échoué, la promesse sera rejetée avec un message d'erreur. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

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

+Cet exemple ouvre l'élément le plus récemment téléchargé : -
function onOpened() {
+```js
+function onOpened() {
   console.log(`Opened download item`);
 }
 
@@ -56,7 +56,7 @@ function onError(error) {
 }
 
 function openDownload(downloadItems) {
-    if (downloadItems.length > 0) {
+    if (downloadItems.length > 0) {
       var opening = browser.downloads.open(downloadItems[0].id);
       opening.then(onOpened, onError);
     }
@@ -67,19 +67,18 @@ var searching = browser.downloads.search({
   orderBy: ["-startTime"]
 });
 
-searching.then(openDownload, onError);
+searching.then(openDownload, onError); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + 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 index 2a72e562eb..5e6b50dc4b 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/pause/index.md @@ -13,37 +13,37 @@ tags: - pause translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/pause --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

C'est une fonction asynchrone qui renvoie une Promise.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

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

Paramètres

+### Paramètres -
-
downloadId
-
Un integer représetant l'id du téléchargement à mettre en pause.
-
+- `downloadId` + - : Un `integer` représetant l'`id` du téléchargement à mettre en pause. -

Valeur retournée

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

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

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -
function onPaused() {
+```js
+function onPaused() {
   console.log(`Paused download`);
 }
 
@@ -52,19 +52,18 @@ function onError(error) {
 }
 
 var pausing = browser.downloads.pause(downloadId);
-pausing.then(onPaused, onError);
+pausing.then(onPaused, onError); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + diff --git a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md index 4bc3a2a440..877b2e17e7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/removefile/index.md @@ -13,47 +13,45 @@ tags: - removeFile translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/removeFile --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

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

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

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

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

C'est une fonction asynchrone qui renvoie une Promise.

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -
-

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

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

Syntaxe

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

Paramètres

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

Valeur retournée

+### Valeur retournée -

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

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a été acceptée, la promesse sera remplie sans arguments. Si la demande a échoué, la promesse sera rejetée avec un message d'erreur. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

Supprimer le dernier fichier téléchargé :

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + 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 index 61ff022edf..74b430a332 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/resume/index.md @@ -13,37 +13,37 @@ tags: - resume translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/resume --- -
{{AddonSidebar()}}
+{{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.

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

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

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

Paramètres

+### Paramètres -
-
downloadId
-
Un integer représentant l'id du téléchargement à reprendre.
-
+- `downloadId` + - : Un `integer` représentant l'`id` du téléchargement à reprendre. -

Valeur retournée

+### Valeur retournée -

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

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). Si la demande a été acceptée, la promesse sera remplie sans arguments. Si la demande a échoué, la promesse sera rejetée avec un message d'erreur. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -
var downloadId = 2;
+```js
+var downloadId = 2;
 
 function onResumed() {
   console.log(`Resumed download`);
@@ -54,19 +54,18 @@ function onError(error) {
 }
 
 var resuming = browser.downloads.resume(downloadId);
-resuming.then(onResumed, onError);
+resuming.then(onResumed, onError); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + 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 index 5f7fa9d84c..75fba0b484 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/search/index.md @@ -14,39 +14,39 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/search --- -
{{AddonSidebar()}}
+{{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.

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

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

+## Syntaxe -
var searching = browser.downloads.search(query);
-
+```js +var searching = browser.downloads.search(query); +``` -

Paramètres

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

Return value

+### Return value -

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

+Une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). La promise est remplie avec un `tableau d'objets` `{{WebExtAPIRef('downloads.DownloadItem')}}` qui correspondent aux critères donnés. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

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

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

+### Obtenez les téléchargements correspondant à "query" -
function logDownloads(downloads) {
+```js
+function logDownloads(downloads) {
   for (let download of downloads) {
     console.log(download.id);
     console.log(download.url);
@@ -61,13 +61,15 @@ var searching = browser.downloads.search({
   query:["imgur"]
 });
 
-searching.then(logDownloads, onError);
+searching.then(logDownloads, onError); +``` -

Obtenez un article spécifique

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

+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) {
+```js
+function logDownloads(downloads) {
   for (let download of downloads) {
     console.log(download.id);
     console.log(download.url);
@@ -82,13 +84,14 @@ var id = 13;
 
 var searching = browser.downloads.search({id});
 searching.then(logDownloads, onError);
-
+``` -

Obtenez tous les téléchargements

+### Obtenez tous les téléchargements -

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

+Si vous voulez renvoyer tout {{WebExtAPIRef("downloads.DownloadItem", "DownloadItems")}}, définissez la `query` sur un objet vide. -
function logDownloads(downloads) {
+```js
+function logDownloads(downloads) {
   for (let download of downloads) {
     console.log(download.id);
     console.log(download.url);
@@ -100,13 +103,15 @@ function onError(error) {
 }
 
 var searching = browser.downloads.search({});
-searching.then(logDownloads, onError);
+searching.then(logDownloads, onError); +``` -

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

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

+Vous pouvez obtenir le téléchargement le plus récent en spécifiant les paramètres de recherche suivants : -
function logDownloads(downloads) {
+```js
+function logDownloads(downloads) {
   for (let download of downloads) {
     console.log(download.id);
     console.log(download.url);
@@ -121,21 +126,20 @@ 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}}

+searching.then(logDownloads, onError); +``` -

Note :

+Vous pouvez voir ce code en action par exemple dans notre [dernier téléchargement](https://github.com/mdn/webextensions-examples/blob/master/latest-download/popup/latest_download.js). -

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

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. - + 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 index e3a1a60755..87ccc4f8c7 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/setshelfenabled/index.md @@ -13,45 +13,40 @@ tags: - setShelfEnabled translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/setShelfEnabled --- -

{{AddonSidebar()}}

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

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

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

-
+> **Note :** Pour utiliser cette fonction dans votre extension, vous devez demander la [permission manifest](/fr/docs/Mozilla/Add-ons/WebExtensions/manifest.json/permissions), `"downloads.shelf"`, ainsi que la permission `"downloads"`. -

Syntaxe

+## Syntaxe -
chrome.downloads.setShelfEnabled(enabled);
-
+```js +chrome.downloads.setShelfEnabled(enabled); +``` -

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

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

Paramètres

+### Paramètres -
-
enabled
-
Un boolean l'état que vous souhaitez définir setShelfEnabled() à — true pour activer et false pour désactiver.
-
+- `enabled` + - : Un `boolean` l'état que vous souhaitez définir `setShelfEnabled()` à — `true` pour activer et `false` pour désactiver. -

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 6e995496ef..e04f4c4b52 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/show/index.md @@ -13,39 +13,39 @@ tags: - show translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/show --- -
{{AddonSidebar()}}
+{{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.

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

+C'est une fonction asynchrone qui renvoie une [`Promise`](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Promise). -

Syntaxe

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

Paramètes

+### Paramètes -
-
downloadId
-
Un integer représentant l'ID du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} à afficher.
-
+- `downloadId` + - : Un `integer` représentant l'ID du {{WebExtAPIRef("downloads.DownloadItem", "DownloadItem")}} à afficher. -

Valeur retournée

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

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

+## Compatibilité du navigateur -

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

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

Exemples

+## Exemples -

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

+Cet exemple montre l'élément le plus récemment téléchargé : -
function onShowing(success) {
+```js
+function onShowing(success) {
   console.log(`Showing download item: ${success}`);
 }
 
@@ -54,7 +54,7 @@ function onError(error) {
 }
 
 function openDownload(downloadItems) {
-    if (downloadItems.length > 0) {
+    if (downloadItems.length > 0) {
       latestDownloadId = downloadItems[0].id;
       var showing = browser.downloads.show(latestDownloadId);
       showing.then(onShowing, onError);
@@ -66,19 +66,18 @@ var searching = browser.downloads.search({
   orderBy: ["-startTime"]
 });
 
-searching.then(openDownload, onError);
+searching.then(openDownload, onError); +``` -

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - + 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 index 110f2e13a7..2d64ffe7cf 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/showdefaultfolder/index.md @@ -14,43 +14,45 @@ tags: - downloads translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/showDefaultFolder --- -
{{AddonSidebar()}}
+{{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.

+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

+## Syntaxe -
browser.downloads.showDefaultFolder();
-
+```js +browser.downloads.showDefaultFolder(); +``` -

Paramètres

-

Aucun

+### Paramètres -

Compatibilité du navigateur

+Aucun -

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

+## Compatibilité du navigateur -

Exemples

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

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 :

+## Exemples -
var showBtn = document.querySelector('.show');
+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 :
+
+```js
+var showBtn = document.querySelector('.show');
 
 showBtn.onclick = function() {
   browser.downloads.showDefaultFolder();
-}
- -

{{WebExtExamples}}

- -

Note :

+} +``` -

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

+{{WebExtExamples}} -

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.

-
+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. - 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 index e266b1a584..c99d21a9fd 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/state/index.md @@ -13,44 +13,38 @@ tags: - state translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/State --- -

{{AddonSidebar()}}

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

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

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

Type

+## Type -

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

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

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

Compatibilité du navigateur

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

-
- - 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 index 793fcafab1..a1528c00f4 100644 --- a/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md +++ b/files/fr/mozilla/add-ons/webextensions/api/downloads/stringdelta/index.md @@ -13,36 +13,32 @@ tags: - download translation_of: Mozilla/Add-ons/WebExtensions/API/downloads/StringDelta --- -
{{AddonSidebar()}}
+{{AddonSidebar()}} -

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

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

Type

+## Type -

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

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

+## Compatibilité du navigateur -

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

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

{{WebExtExamples}}

+{{WebExtExamples}} -

Note :

+> **Note :** +> +> Cette API est basée sur l'API Chromium [`chrome.downloads`](https://developer.chrome.com/extensions/downloads). +> +> Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis. -

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

- -

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

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