KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Response.blob(): een antwoordbody lezen als Blob

De methode response.blob() leest de volledige antwoordbody en retourneert een Promise<Blob> met de bytes ervan.

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

Syntax

response.blob() // Promise<Blob>

Response.blob verwijst hier naar de instantiemethode response.blob(), niet naar een statische methode. De methode heeft geen argumenten. Ze leest de volledige body in een Blob; het MIME-type komt uit Content-Type of is "" als er geen type wordt herkend.

Als response.body null is, kan de promise bij elke aanroep van response.blob() worden vervuld met een lege Blob, ook als je de methode vaker aanroept. Heeft het antwoord een body in de vorm van een stream, dan wordt de promise afgewezen met een TypeError als de stream vergrendeld is of de status ‘disturbed’ heeft (bijvoorbeeld omdat het lezen al is begonnen of omdat de stream is geannuleerd). Als je de inhoud van de stream twee keer wilt lezen, roep je vóór het lezen response.clone() aan. Ook streamfouten wijzen de promise af.

De methode controleert response.ok niet. Dit is een Web API uit de Fetch Standard, geen functie van een bepaalde ECMAScript-editie; controleer of de methode beschikbaar is in je doelomgeving.

Voorbeelden

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);

Resultaat

5
text/plain
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen