CKTIS / JavaScript
Response.text() — čtení těla jako textu
Response.text() přečte celé tělo odpovědi a vrátí Promise s textem dekódovaným jako UTF-8.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
response.text() // Promise<string>response.text() vrátí Promise<string>, která se splní po přečtení celého těla. Bajty dekóduje jako UTF-8 bez ohledu na charset v Content-Type. JSON neparsuje.
Pokud je response.body rovno null, při každém volání se Promise splní s prázdným řetězcem a bodyUsed zůstane false. Pokud je tělo proudem, jeho čtení nastaví bodyUsed na true, i když proud neobsahuje žádné bajty. Pokud už čtení proudu začalo, proud byl zrušen nebo je uzamčený, Promise se zamítne s chybou TypeError. Pokud potřebujete tělo ve formě proudu přečíst dvakrát, zavolejte response.clone() ještě před prvním čtením.
Metoda ukládá celé tělo do vyrovnávací paměti, proto berte v úvahu spotřebu paměti. Nekontroluje response.ok. Jde o Web API definované standardem Fetch Standard, nikoli o funkci ECMAScriptu.
Příklady
(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);Výsledek
Cześć! true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.