Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Response.blob(): leggere il corpo di una risposta come Blob

Il metodo response.blob() legge l’intero corpo della risposta e restituisce un Promise<Blob> che ne contiene i byte.

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

Sintassi

response.blob() // Promise<Blob>

Response.blob indica qui il metodo di istanza response.blob(), non un metodo statico. Non accetta argomenti. Legge l’intero corpo in un Blob; il tipo MIME proviene da Content-Type oppure è "" se non viene riconosciuto alcun tipo.

Se response.body è null, la promise di ciascuna chiamata a response.blob() può risolversi con un Blob vuoto, anche se il metodo è già stato chiamato. Se il corpo della risposta è uno stream, la promise viene rifiutata con un TypeError quando lo stream è bloccato o nello stato «disturbed» (per esempio, perché la lettura è già iniziata o lo stream è stato annullato). Per leggere due volte il contenuto dello stream, chiama response.clone() prima della lettura. Anche gli errori dello stream rifiutano la promise.

Il metodo non controlla response.ok. È una Web API del Fetch Standard, non una funzionalità di una specifica edizione di ECMAScript; verifica che sia disponibile nell’ambiente di destinazione.

Esempi

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

Risultato

5
text/plain
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti