Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Response.blob(): leer el cuerpo de una respuesta como Blob

El método response.blob() lee todo el cuerpo de la respuesta y devuelve un Promise<Blob> que contiene sus bytes.

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

Sintaxis

response.blob() // Promise<Blob>

Response.blob se refiere aquí al método de instancia response.blob(), no a un método estático. No acepta argumentos. Lee todo el cuerpo en un Blob; su tipo MIME procede de Content-Type o es "" si no se reconoce ninguno.

Si response.body es null, en cada llamada a response.blob() la promesa puede resolverse con un Blob vacío, aunque el método ya se haya llamado antes. Si el cuerpo de la respuesta es un flujo, la promesa se rechaza con un TypeError cuando el flujo está bloqueado o en estado «disturbed» (por ejemplo, porque ya se ha empezado a leer o se ha cancelado). Para leer dos veces el contenido del flujo, llama a response.clone() antes de la lectura. Los errores del flujo también hacen que se rechace la promesa.

El método no comprueba response.ok. Es una API Web del Fetch Standard, no una característica de una edición concreta de ECMAScript; comprueba su disponibilidad en el entorno de destino.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes