Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje