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

CKTIS / JavaScript

Response.text() — ler um corpo como texto

Response.text() lê todo o corpo da resposta e devolve uma Promise com texto descodificado como UTF-8.

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

response.text() devolve uma Promise<string> que é resolvida após a leitura de todo o corpo. Descodifica os bytes como UTF-8, independentemente do charset em Content-Type. Não analisa JSON.

Se response.body for null, a promessa devolvida por cada chamada é resolvida com uma cadeia vazia e bodyUsed mantém-se a false. Se o corpo for um fluxo, a sua leitura faz com que bodyUsed passe a true, mesmo que o fluxo não contenha nenhum byte. Se a leitura do fluxo já tiver começado, se o fluxo tiver sido cancelado ou se estiver bloqueado, a promessa é rejeitada com um TypeError. Para ler duas vezes um corpo fornecido como fluxo, chama response.clone() antes da primeira leitura.

O método coloca todo o corpo em memória intermédia, por isso tem em conta a utilização de memória. Não verifica response.ok. Trata-se de uma Web API definida pelo Fetch Standard, não de uma funcionalidade ECMAScript.

Exemplos

(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

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