Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Response.blob() : lire le corps d’une réponse sous forme de Blob

La méthode response.blob() lit l’intégralité du corps de la réponse et renvoie un Promise<Blob> contenant ses octets.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

response.blob() // Promise<Blob>

Response.blob désigne ici la méthode d’instance response.blob(), et non une méthode statique. Elle ne prend aucun argument. Elle lit l’intégralité du corps dans un Blob ; son type MIME provient de Content-Type, ou vaut "" si aucun type n’est reconnu.

Si response.body vaut null, des appels répétés à response.blob() peuvent chacun produire une promesse résolue avec un Blob vide. Si le corps de la réponse est un flux, la promesse est rejetée avec une TypeError lorsque le flux est verrouillé ou dans l’état « disturbed » (par exemple, si sa lecture a déjà commencé ou si le flux a été annulé). Pour lire deux fois le contenu du flux, appelez response.clone() avant la lecture. Les erreurs de flux entraînent également le rejet de la promesse.

La méthode ne vérifie pas response.ok. Il s’agit d’une API Web du Fetch Standard, et non d’une fonctionnalité propre à une édition d’ECMAScript ; vérifiez sa disponibilité dans votre environnement cible.

Exemples

async function main() {
  const response = new Response("Hello", {
    headers: { "Content-Type": "text/plain" }
  });
  const blob = await response.blob();

  console.log(blob.size);
  console.log(blob.type);
  console.log(response.bodyUsed);
}

main().catch(console.error);

Résultat

5
text/plain
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources