Body

Le mixin Body de l'API Fetch représente le corps de d'une requête ou d'une réponse, vous permettant de déclarer le type de son contenu et comment le manipuler.

Body est implémenté par Request et Response. Ces derniers fournissent un objet avec un un corps associé (un stream), un drapeaux pour indiquer si le corps a déjà été utilisé (initialisé à faux), et un type MIME (au début, une séquence vide d'octet).

Propriétés

Body.body Lecture seule
Un simple getter utilisé pour obtenir un ReadableStream du contenu.
Body.bodyUsed Lecture seule
Un Boolean qui indique si le corps a déjà été lu.

Méthodes

Body.arrayBuffer()
Prend un flux Response, le lit en entier, et le retourne sous forme d'un ArrayBuffer au travers d'une promesse.
Body.blob()
Prends un flux Response, le lit en entier, et le retourne dans un Blob au travers d'une promesse.
Body.formData()
Prends un flux Response, le lit en entier, et le retourne dans un objet FormData au travers d'une promesse.
Body.json()
Prends un flux Response, le lit en entier et retourne une promesse résolue avec le résultat textuel interprété comme du JSON.
Body.text()
Prend un flux Response, le lit en entier, et le retourne dans une USVString (texte) au travers d'une promesse. La réponse est toujours décodée en utilisant l'UTF-8.

Exemples

L'exemple suivant utilise un simple appel fetch pour récupérer une image et l'afficher dans un élément <img>. Notez qu'une fois l'image téléchargée, nous devons appeler Body.blob() (Response implémente body) pour connaître le MIME type correcte.

Code HTML

<img class="my-image" src="https://wikipedia.org/static/images/project-logos/frwiki-1.5x.png">

Code JavaScript

const myImage = document.querySelector('.my-image');
fetch('https://upload.wikimedia.org/wikipedia/commons/7/77/Delete_key1.jpg')
	.then(res => res.blob())
	.then(res => {
		const objectURL = URL.createObjectURL(res);
		myImage.src = objectURL;
});

Spécifications

Spécifications Status Commentaire
Fetch
La définition de 'Body' dans cette spécification.
Standard évolutif

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi