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.