aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/blob
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-02 17:20:24 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-10-02 17:30:20 +0200
commit1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch)
tree30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/blob
parentc05efa8d7ae464235cf83d7c0956e42dc6974103 (diff)
downloadtranslated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2
translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip
convert content to md
Diffstat (limited to 'files/fr/web/api/blob')
-rw-r--r--files/fr/web/api/blob/blob/index.md81
-rw-r--r--files/fr/web/api/blob/index.md130
-rw-r--r--files/fr/web/api/blob/size/index.md30
-rw-r--r--files/fr/web/api/blob/type/index.md60
4 files changed, 121 insertions, 180 deletions
diff --git a/files/fr/web/api/blob/blob/index.md b/files/fr/web/api/blob/blob/index.md
index eb08cd3667..94d84cdac1 100644
--- a/files/fr/web/api/blob/blob/index.md
+++ b/files/fr/web/api/blob/blob/index.md
@@ -10,68 +10,51 @@ tags:
- Reference
translation_of: Web/API/Blob/Blob
---
-<div>{{APIRef("File API")}}</div>
+{{APIRef("File API")}}
-<p>Le constructeur <code><strong>Blob()</strong></code> retourne un nouvel objet {{domxref("Blob")}}. Le contenu d'un blob consiste en une concaténation de valeurs données dans le tableau passé en paramètre.</p>
+Le constructeur **`Blob()`** retourne un nouvel objet {{domxref("Blob")}}. Le contenu d'un blob consiste en une concaténation de valeurs données dans le tableau passé en paramètre.
-<h2 id="Syntaxe">Syntaxe</h2>
+## Syntaxe
-<pre class="syntaxbox">var aBlob = new Blob(<em> array</em>)
-var aBlob = new Blob( <em>array</em>, <em>options</em> );
-</pre>
+ var aBlob = new Blob( array)
+ var aBlob = new Blob( array, options );
-<h3 id="Paramètres">Paramètres</h3>
+### Paramètres
-<dl>
- <dt><code>array</code></dt>
- <dd>Un tableau ({{jsxref("Array")}}) d'objets de type {{jsxref("ArrayBuffer")}}, {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, ou un mélange de tels objets qui seront insérés dans le {{domxref("Blob")}}. Les chaînes <code>DOMString</code> seront encodées en UTF-8.</dd>
- <dt><code>options</code> {{optional_inline}}</dt>
- <dd>Un paramètre optionnel qui est un dictionnaire <code>BlobPropertyBag</code> et qui peut être utilisé pour définir les deux attributs suivants :
- <ul>
- <li><code>type</code> : cet attribut représente le type MIME du contenu du tableau qui sera inséré dans le blob. La valeur par défaut pour cette propriété est la chaîne vide <code>""</code>.</li>
- <li><code>endings</code> : cet attribut spécifie la façon dont les chaînes qui contiennent des sauts de lignes (<code>\n</code>) doivent être retranscrites. Il peut prendre l'une de ces valeurs :
- <ul>
- <li><code>"native"</code> indiquera que les caractères de fin doivent être adaptés pour correspondre à ceux utilisés par le système d'exploitation</li>
- <li><code>"transparent"</code> indiquera que les fin de lignes sont stockées telles quelles dans le blob (aucune modification).</li>
- </ul>
- La valeur par défaut pour cet attribut est <code>"transparent"</code>. {{non-standard_inline}}</li>
- </ul>
- </dd>
-</dl>
+- `array`
+ - : Un tableau ({{jsxref("Array")}}) d'objets de type {{jsxref("ArrayBuffer")}}, {{domxref("ArrayBufferView")}}, {{domxref("Blob")}}, {{domxref("DOMString")}}, ou un mélange de tels objets qui seront insérés dans le {{domxref("Blob")}}. Les chaînes `DOMString` seront encodées en UTF-8.
+- `options` {{optional_inline}}
-<h2 id="Exemples">Exemples</h2>
+ - : Un paramètre optionnel qui est un dictionnaire `BlobPropertyBag` et qui peut être utilisé pour définir les deux attributs suivants :
-<pre class="brush: js">// Un tableau qui contient une seule DOMString
-var aFileParts = ['&lt;a id="a"&gt;&lt;b id="b"&gt;Coucou :) !&lt;/b&gt;&lt;/a&gt;'];
+ - `type` : cet attribut représente le type MIME du contenu du tableau qui sera inséré dans le blob. La valeur par défaut pour cette propriété est la chaîne vide `""`.
+ - `endings` : cet attribut spécifie la façon dont les chaînes qui contiennent des sauts de lignes (`\n`) doivent être retranscrites. Il peut prendre l'une de ces valeurs :
-// Le blob
-var oMyBlob = new Blob(aFileParts, {type : 'text/html'});</pre>
+ - `"native"` indiquera que les caractères de fin doivent être adaptés pour correspondre à ceux utilisés par le système d'exploitation
+ - `"transparent"` indiquera que les fin de lignes sont stockées telles quelles dans le blob (aucune modification).
+
+ La valeur par défaut pour cet attribut est `"transparent"`. {{non-standard_inline}}
-<h2 id="Spécifications">Spécifications</h2>
+## Exemples
-<table class="standard-table">
- <tbody>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">État</th>
- <th scope="col">Commentaires</th>
- </tr>
- <tr>
- <td>{{SpecName('File API', '#constructorBlob', 'Blob()')}}</td>
- <td>{{Spec2('File API')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
+```js
+// Un tableau qui contient une seule DOMString
+var aFileParts = ['<a id="a"><b id="b">Coucou :) !</b></a>'];
+
+// Le blob
+var oMyBlob = new Blob(aFileParts, {type : 'text/html'});
+```
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+## Spécifications
+| Spécification | État | Commentaires |
+| ------------------------------------------------------------------------ | ---------------------------- | -------------------- |
+| {{SpecName('File API', '#constructorBlob', 'Blob()')}} | {{Spec2('File API')}} | Définition initiale. |
+## Compatibilité des navigateurs
-<p>{{Compat("api.Blob.Blob")}}</p>
+{{Compat("api.Blob.Blob")}}
-<h2 id="Voir_aussi">Voir aussi</h2>
+## Voir aussi
-<ul>
- <li>Le déprécié {{domxref("BlobBuilder")}} qui a été remplacé par ce constructeur.</li>
-</ul>
+- Le déprécié {{domxref("BlobBuilder")}} qui a été remplacé par ce constructeur.
diff --git a/files/fr/web/api/blob/index.md b/files/fr/web/api/blob/index.md
index 6cf6467846..3e79c90f0f 100644
--- a/files/fr/web/api/blob/index.md
+++ b/files/fr/web/api/blob/index.md
@@ -7,61 +7,52 @@ tags:
- WebAPI
translation_of: Web/API/Blob
---
-<div>{{APIRef("File API")}}</div>
+{{APIRef("File API")}}
-<p>Un objet <strong><code>Blob</code></strong> représente un objet, semblable à un fichier, qui est immuable et qui contient des données brutes. Les <em>blobs</em> (pour <em><strong>B</strong>inary <strong>L</strong>arge <strong>Ob</strong>jects</em>) représentent des données qui ne sont pas dans un format JavaScript natif. L'interface {{domxref("File")}} est basée sur l'interface <code>Blob</code> et hérite des fonctionnalités de cette dernière tout en ajoutant des fonctionnalités pour gérer les fichiers sur le système de l'utilisateur.</p>
+Un objet **`Blob`** représente un objet, semblable à un fichier, qui est immuable et qui contient des données brutes. Les _blobs_ (pour **\*B**inary **L**arge **Ob**jects\*) représentent des données qui ne sont pas dans un format JavaScript natif. L'interface {{domxref("File")}} est basée sur l'interface `Blob` et hérite des fonctionnalités de cette dernière tout en ajoutant des fonctionnalités pour gérer les fichiers sur le système de l'utilisateur.
-<p>Pour construire un <code>Blob</code> à partir d'objets qui ne sont pas des blobs ou à partir d'autres données, on pourra utiliser le constructeur {{domxref("Blob.Blob", "Blob()")}}. Pour créer un blob qui contient un sous-ensemble d'un autre blob, on pourra employer la méthode {{domxref("Blob.slice()", "slice()")}}. Pour obtenir un <code>Blob</code> à partir d'un fichier du système de l'utilisateur, consulter la documentation {{domxref("File")}}.</p>
+Pour construire un `Blob` à partir d'objets qui ne sont pas des blobs ou à partir d'autres données, on pourra utiliser le constructeur {{domxref("Blob.Blob", "Blob()")}}. Pour créer un blob qui contient un sous-ensemble d'un autre blob, on pourra employer la méthode {{domxref("Blob.slice()", "slice()")}}. Pour obtenir un `Blob` à partir d'un fichier du système de l'utilisateur, consulter la documentation {{domxref("File")}}.
-<p>Les API qui acceptent des objets <code>Blob</code> sont également listées sur la documentation de {{domxref("File")}}.</p>
+Les API qui acceptent des objets `Blob` sont également listées sur la documentation de {{domxref("File")}}.
-<div class="note">
-<p><strong>Note :</strong> La méthode <code>slice()</code> utilisait auparavant un deuxième argument qui indiquait le nombre d'octets à copier dans le nouveau blob. Si on utilisait un couple de valeur <code>début + longueur</code> qui dépassait la taille du blob source, le blob qui était renvoyé contenait les données à partir de l'indice de début et jusuq'à la fin du blob.</p>
-</div>
+> **Note :** La méthode `slice()` utilisait auparavant un deuxième argument qui indiquait le nombre d'octets à copier dans le nouveau blob. Si on utilisait un couple de valeur `début + longueur` qui dépassait la taille du blob source, le blob qui était renvoyé contenait les données à partir de l'indice de début et jusuq'à la fin du blob.
-<div class="note">
- <p><strong>Note :</strong> La méthode <code>slice()</code> doit être utilisée avec certains préfixes sur certaines versions de navigateurs : <code>blob.mozSlice()</code> pour Firefox 12 et antérieur, <code>blob.webkitSlice()</code> dans Safari. Un ancienne version de <code>slice()</code> sans préfixes avait une sémantique différente et est désormais obsolète. La prise en charge de <code>blob.mozSlice()</code> a été abandonnée avec Firefox 30.</p>
-</div>
+> **Note :** La méthode `slice()` doit être utilisée avec certains préfixes sur certaines versions de navigateurs : `blob.mozSlice()` pour Firefox 12 et antérieur, `blob.webkitSlice()` dans Safari. Un ancienne version de `slice()` sans préfixes avait une sémantique différente et est désormais obsolète. La prise en charge de `blob.mozSlice()` a été abandonnée avec Firefox 30.
-<h2 id="Constructeur">Constructeur</h2>
+## Constructeur
-<dl>
- <dt>{{domxref("Blob.Blob", "Blob(blobParts[, options])")}}</dt>
- <dd>Ce constructeur renvoie un nouvel objet <code>Blob</code> qui contient la concaténation des valeurs du tableau passé en paramètre.</dd>
-</dl>
+- {{domxref("Blob.Blob", "Blob(blobParts[, options])")}}
+ - : Ce constructeur renvoie un nouvel objet `Blob` qui contient la concaténation des valeurs du tableau passé en paramètre.
-<h2 id="Propriétés">Propriétés</h2>
+## Propriétés
-<dl>
- <dt>{{domxref("Blob.isClosed")}} {{readonlyinline}} {{experimental_inline}}</dt>
- <dd>Un booléen qui indique si la méthode {{domxref("Blob.close()")}} a été appelée sur le blob. Les blobs qui ont été fermés ne peuvent pas être lus.</dd>
- <dt>{{domxref("Blob.size")}} {{readonlyinline}}</dt>
- <dd>La taille des données contenues dans l'objet <code>Blob</code>, exprimée en octets.</dd>
- <dt>{{domxref("Blob.type")}} {{readonlyinline}}</dt>
- <dd>Une chaîne de caractères qui indique le type MIME des données contenues dans le <code>Blob</code>. Si le type est inconnu, la chaîne de caractères est vide.</dd>
-</dl>
+- {{domxref("Blob.isClosed")}} {{readonlyinline}} {{experimental_inline}}
+ - : Un booléen qui indique si la méthode {{domxref("Blob.close()")}} a été appelée sur le blob. Les blobs qui ont été fermés ne peuvent pas être lus.
+- {{domxref("Blob.size")}} {{readonlyinline}}
+ - : La taille des données contenues dans l'objet `Blob`, exprimée en octets.
+- {{domxref("Blob.type")}} {{readonlyinline}}
+ - : Une chaîne de caractères qui indique le type MIME des données contenues dans le `Blob`. Si le type est inconnu, la chaîne de caractères est vide.
-<h2 id="Méthodes">Méthodes</h2>
+## Méthodes
-<dl>
- <dt>{{domxref("Blob.close()")}} {{experimental_inline}}</dt>
- <dd>Cette méthode clotûre le blob et libère éventuellement les ressources sous-jacentes.</dd>
- <dt>{{domxref("Blob.slice()", "Blob.slice([début[, fin[, contentType]]])")}}</dt>
- <dd>Cette méthode renvoie un nouvel objet <code>Blob</code> qui contient les données dans le fragment du <code>Blob</code> source entre <code>début</code> et <code>fin</code>.</dd>
-</dl>
+- {{domxref("Blob.close()")}} {{experimental_inline}}
+ - : Cette méthode clotûre le blob et libère éventuellement les ressources sous-jacentes.
+- {{domxref("Blob.slice()", "Blob.slice([début[, fin[, contentType]]])")}}
+ - : Cette méthode renvoie un nouvel objet `Blob` qui contient les données dans le fragment du `Blob` source entre `début` et `fin`.
-<h2 id="Exemples">Exemples</h2>
+## Exemples
-<h3 id="Utilisation_du_constructeur_Blob">Utilisation du constructeur <code>Blob</code></h3>
+### Utilisation du constructeur `Blob`
-<p>Le constructeur {{domxref("Blob.Blob", "Blob()")}} permet de créer des blobs à partir d'autres objets. Par exemple, on peut construire un blob à partir d'une chaîne de caractères :</p>
+Le constructeur {{domxref("Blob.Blob", "Blob()")}} permet de créer des blobs à partir d'autres objets. Par exemple, on peut construire un blob à partir d'une chaîne de caractères :
-<pre>var debug = {coucou: "monde"};
-var blob = new Blob([JSON.stringify(debug, null, 2)], {type : 'application/json'});</pre>
+ var debug = {coucou: "monde"};
+ var blob = new Blob([JSON.stringify(debug, null, 2)], {type : 'application/json'});
-<h3 id="Créer_une_URL_de_données_vers_un_tableau_typé">Créer une URL de données vers un tableau typé</h3>
+### Créer une URL de données vers un tableau typé
-<pre class="brush: js">var typedArray = GetTheTypedArraySomehow();
+```js
+var typedArray = GetTheTypedArraySomehow();
// On ajoute un type MIME pertinent
var blob = new Blob([typedArray], {type: 'application/octet-binary'});
@@ -73,47 +64,36 @@ var url = URL.createObjectURL(blob);
// désormais on peut utiliser l'URL dans tout
// contexte qui utilise des URL (img.src par
// exemple)
-</pre>
+```
-<h3 id="Extraire_des_données_à_partir_d'un_blob">Extraire des données à partir d'un blob</h3>
+### Extraire des données à partir d'un blob
-<p>La seule façon de lire le contenu d'un blob est d'utiliser un objet {{domxref("FileReader")}}. Dans le code qui suit, on lit le contenu d'un blob sous la forme d'un tableau typé.</p>
+La seule façon de lire le contenu d'un blob est d'utiliser un objet {{domxref("FileReader")}}. Dans le code qui suit, on lit le contenu d'un blob sous la forme d'un tableau typé.
-<pre class="brush: js">var reader = new FileReader();
+```js
+var reader = new FileReader();
reader.addEventListener("loadend", function() {
// reader.result contient le contenu du
// blob sous la forme d'un tableau typé
});
-reader.readAsArrayBuffer(blob);</pre>
-
-<p>En utilisant d'autres méthodes de {{domxref("FileReader")}}, on peut lire le contenu du blob si c'est une chaîne ou une URL de données.</p>
-
-<h2 id="Spécifications">Spécifications</h2>
-
-<table class="standard-table">
- <tbody>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">État</th>
- <th scope="col">Commentaires</th>
- </tr>
- <tr>
- <td>{{SpecName('File API','#blob','Blob')}}</td>
- <td>{{Spec2('File API')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
-
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
-
-<p>{{Compat("api.Blob")}}</p>
-
-<h2 id="Voir_aussi">Voir aussi</h2>
-
-<ul>
- <li>{{domxref("BlobBuilder")}}</li>
- <li>{{domxref("File")}}</li>
- <li>{{domxref("URL.createObjectURL")}}</li>
- <li><a href="/fr/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.importGlobalProperties">Components.utils.importGlobalProperties</a></li>
-</ul>
+reader.readAsArrayBuffer(blob);
+```
+
+En utilisant d'autres méthodes de {{domxref("FileReader")}}, on peut lire le contenu du blob si c'est une chaîne ou une URL de données.
+
+## Spécifications
+
+| Spécification | État | Commentaires |
+| ---------------------------------------------------- | ---------------------------- | -------------------- |
+| {{SpecName('File API','#blob','Blob')}} | {{Spec2('File API')}} | Définition initiale. |
+
+## Compatibilité des navigateurs
+
+{{Compat("api.Blob")}}
+
+## Voir aussi
+
+- {{domxref("BlobBuilder")}}
+- {{domxref("File")}}
+- {{domxref("URL.createObjectURL")}}
+- [Components.utils.importGlobalProperties](/fr/docs/Mozilla/Tech/XPCOM/Language_Bindings/Components.utils.importGlobalProperties)
diff --git a/files/fr/web/api/blob/size/index.md b/files/fr/web/api/blob/size/index.md
index b82751abd0..495747778f 100644
--- a/files/fr/web/api/blob/size/index.md
+++ b/files/fr/web/api/blob/size/index.md
@@ -9,32 +9,28 @@ tags:
translation_of: Web/API/File/fileSize
original_slug: Web/API/File/fileSize
---
-<p>{{APIRef("File API") }}{{non-standard_header}}</p>
+{{APIRef("File API") }}{{non-standard_header}}
-<p>{{obsolete_header(7.0)}}</p>
+{{obsolete_header(7.0)}}
-<h2 id="Résumé">Résumé</h2>
+## Résumé
-<p>Renvoie la taille du fichier en octets.</p>
+Renvoie la taille du fichier en octets.
-<div class="note">
- <p><strong>Note :</strong> Cette propriété est dépréciée. Utilisez {{domxref("Blob.size")}} à la place.</p>
-</div>
+> **Note :** Cette propriété est dépréciée. Utilisez {{domxref("Blob.size")}} à la place.
-<h2 id="Syntaxe">Syntaxe</h2>
+## Syntaxe
-<pre>var size = <em>instanceOfFile</em>.fileSize</pre>
+ var size = instanceOfFile.fileSize
-<h2 id="Valeur">Valeur</h2>
+## Valeur
-<p>Un nombre.</p>
+Un nombre.
-<h2 id="Spécification">Spécification</h2>
+## Spécification
-<p>Ne fait partie d'aucune spécification.</p>
+Ne fait partie d'aucune spécification.
-<h2 id="Voir_aussi">Voir aussi</h2>
+## Voir aussi
-<ul>
- <li>{{domxref("Blob.size")}}</li>
-</ul>
+- {{domxref("Blob.size")}}
diff --git a/files/fr/web/api/blob/type/index.md b/files/fr/web/api/blob/type/index.md
index 8823dd1bb9..166428cb4a 100644
--- a/files/fr/web/api/blob/type/index.md
+++ b/files/fr/web/api/blob/type/index.md
@@ -8,23 +8,24 @@ tags:
- Propriété
translation_of: Web/API/Blob/type
---
-<div>{{APIRef("File API")}}</div>
+{{APIRef("File API")}}
-<p>La propriété <strong><code>type</code></strong> de l'objet <a href="fr/docs/Web/API/Blob"><code>Blob</code></a> fourni le type MIME (Internet media type) d'un fichier. Celle-ci retourne une chaîne de caractère vide si le type n'a pas pu être déterminé.</p>
+La propriété **`type`** de l'objet [`Blob`](fr/docs/Web/API/Blob) fourni le type MIME (Internet media type) d'un fichier. Celle-ci retourne une chaîne de caractère vide si le type n'a pas pu être déterminé.
-<h2 id="Syntaxe">Syntaxe</h2>
+## Syntaxe
-<pre class="syntaxbox">var mimetype = <var>instanceOfFile</var>.type</pre>
+ var mimetype = instanceOfFile.type
-<h2 id="Valeur">Valeur</h2>
+## Valeur
-<p>Une chaîne de caractères (par exemple : "image/png").</p>
+Une chaîne de caractères (par exemple : "image/png").
-<h2 id="Exemple">Exemple</h2>
+## Exemple
-<pre class="brush:js">var i, fileInput, files, allowedFileTypes;
+```js
+var i, fileInput, files, allowedFileTypes;
-// fileInput est un HTMLInputElement: &lt;input type="file" multiple id="myfileinput"&gt;
+// fileInput est un HTMLInputElement: <input type="file" multiple id="myfileinput">
fileInput = document.getElementById("myfileinput");
// files est un objet FileList (similaire à NodeList)
@@ -33,43 +34,24 @@ files = fileInput.files;
// notre application accepte seulement les images de type *.png, *.jpeg et *.gif
allowedFileTypes = ["image/png", "image/jpeg", "image/gif"];
-for (i = 0; i &lt; files.length; i++) {
+for (i = 0; i < files.length; i++) {
// Vérifie si file.type est un type autorisé.
- if (allowedFileTypes.indexOf(<strong>files[i].type</strong>) &gt; -1) {
+ if (allowedFileTypes.indexOf(files[i].type) > -1) {
// le type du fichier (file) correspond à l'un des types autorisés. Faites quelque chose ici.
}
});
-</pre>
+```
-<h2 id="Spécifications">Spécifications</h2>
+## Spécifications
-<table class="standard-table">
- <tbody>
- <tr>
- <th scope="col">Spécification</th>
- <th scope="col">Statut</th>
- <th scope="col">Commentaire</th>
- </tr>
- <tr>
- <td>{{SpecName('File API', '#dfn-type', 'type')}}</td>
- <td>{{Spec2('File API')}}</td>
- <td>Définition initiale.</td>
- </tr>
- </tbody>
-</table>
+| Spécification | Statut | Commentaire |
+| ------------------------------------------------------------ | ---------------------------- | -------------------- |
+| {{SpecName('File API', '#dfn-type', 'type')}} | {{Spec2('File API')}} | Définition initiale. |
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
+## Compatibilité des navigateurs
-<div>
-<div>
+{{Compat("api.Blob.type")}}
+## Voir aussi
-<p>{{Compat("api.Blob.type")}}</p>
-</div>
-
-<h2 id="Voir_aussi">Voir aussi</h2>
-</div>
-
-<ul>
- <li>{{domxref("Blob")}}</li>
-</ul>
+- {{domxref("Blob")}}