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.