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

CKTIS / JavaScript

Response.text() — leer un cuerpo como texto

Response.text() lee todo el cuerpo de la respuesta y devuelve una Promise con texto decodificado como UTF-8.

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.text() // Promise<string>

response.text() devuelve una Promise<string> que se resuelve después de leer todo el cuerpo. Decodifica los bytes como UTF-8 independientemente del charset de Content-Type. No analiza JSON.

Si response.body es null, la promesa de cada llamada se resuelve con una cadena vacía y bodyUsed sigue siendo false. Si el cuerpo es un flujo, leerlo hace que bodyUsed pase a true, aunque el flujo no contenga ningún byte. Si ya se ha empezado a leer el flujo, se ha cancelado o está bloqueado, la promesa se rechaza con un TypeError. Para leer dos veces un cuerpo proporcionado como flujo, llama a response.clone() antes de la primera lectura.

El método almacena en búfer todo el cuerpo, así que ten en cuenta el uso de memoria. No comprueba response.ok. Es una API Web definida por el Fetch Standard, no una característica de ECMAScript.

Ejemplos

(async () => {
  const response = new Response("Cześć!", {
    headers: { "Content-Type": "text/plain; charset=utf-8" }
  });
  console.log(await response.text());
  console.log(response.bodyUsed);
})().catch(console.error);

Resultado

Cześć!
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