Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Response.blob(): ler o corpo de uma resposta como Blob

O método response.blob() lê todo o corpo da resposta e devolve um Promise<Blob> com os respetivos bytes.

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

Sintaxe

response.blob() // Promise<Blob>

Response.blob refere-se aqui ao método de instância response.blob(), não a um método estático. Não recebe argumentos. Lê todo o corpo para um Blob; o tipo MIME provém de Content-Type ou é "" quando não é reconhecido nenhum tipo.

Se response.body for null, a promessa de cada chamada a response.blob() pode ser resolvida com um Blob vazio, mesmo em chamadas repetidas. Se o corpo da resposta for um fluxo, a promessa é rejeitada com um TypeError quando o fluxo está bloqueado ou no estado «disturbed» (por exemplo, porque a leitura já começou ou o fluxo foi cancelado). Para leres duas vezes o conteúdo do fluxo, chama response.clone() antes da leitura. Os erros do fluxo também rejeitam a promessa.

O método não verifica response.ok. É uma API Web do Fetch Standard, não uma funcionalidade de uma edição específica do ECMAScript; verifica a disponibilidade no ambiente de destino.

Exemplos

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

Resultado

5
text/plain
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes