CKTIS / JavaScript
Response.text() — een body als tekst lezen
Response.text() leest de volledige response-body en geeft een Promise terug met tekst die als UTF-8 is gedecodeerd.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
response.text() // Promise<string>response.text() geeft een Promise<string> terug die wordt vervuld zodra de volledige body is gelezen. De methode decodeert bytes als UTF-8, ongeacht de charset in Content-Type. JSON wordt niet geparseerd.
Als response.body gelijk is aan null, wordt de Promise bij elke aanroep vervuld met een lege tekenreeks en blijft bodyUsed op false staan. Als de body een stream is, wordt bodyUsed bij het lezen true, zelfs als de stream geen bytes bevat. Als het lezen al is begonnen, de stream is geannuleerd of de stream is vergrendeld, wordt de Promise afgewezen met een TypeError. Wil je een body die als stream beschikbaar is twee keer lezen, roep dan vóór de eerste keer response.clone() aan.
De methode buffert de volledige body, dus houd rekening met het geheugengebruik. De methode controleert response.ok niet. Dit is een Web API die is gedefinieerd door de Fetch Standard, geen ECMAScript-functie.
Voorbeelden
(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);Resultaat
Cześć! true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.