Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Response.text() — odczyt treści jako tekstu

Response.text() odczytuje całą treść odpowiedzi i zwraca Promise z tekstem zdekodowanym jako UTF-8.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

response.text() // Promise<string>

response.text() zwraca Promise<string>, która spełnia się po odczytaniu całej treści. Dekoduje bajty jako UTF-8 niezależnie od charset w Content-Type. Nie parsuje JSON.

Jeśli response.body ma wartość null, każde wywołanie zwraca obietnicę spełnianą pustym ciągiem, a bodyUsed pozostaje false. Jeśli treść jest strumieniem, jego odczyt ustawia bodyUsed na true, nawet gdy strumień nie zawiera żadnych bajtów. Jeśli odczyt strumienia już rozpoczęto, strumień anulowano lub jest on zablokowany, obietnica zostaje odrzucona z błędem TypeError. Jeśli potrzebujesz dwóch odczytów strumienia, użyj response.clone() przed pierwszym.

Metoda buforuje całą treść, więc uwzględnij zużycie pamięci. Sama nie sprawdza response.ok. To Web API zdefiniowane przez Fetch Standard, nie funkcja ECMAScript.

Przykłady

(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);

Wynik

Cześć!
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła