WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Response.text() — den Body als Text lesen

Response.text() liest den gesamten Response-Body und gibt ein Promise mit Text zurück, der als UTF-8 dekodiert wurde.

Version: 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() gibt ein Promise<string> zurück, das erfüllt wird, sobald der gesamte Body gelesen wurde. Die Methode dekodiert Bytes unabhängig vom charset in Content-Type als UTF-8. Sie parst kein JSON.

Ist response.body gleich null, wird das Promise bei jedem Aufruf mit einer leeren Zeichenfolge erfüllt, und bodyUsed bleibt false. Ist ein Body-Stream vorhanden, setzt das Lesen bodyUsed auf true, selbst wenn der Stream keine Bytes enthält. Wurde bereits begonnen, den Stream zu lesen, wurde er abgebrochen oder ist er gesperrt, wird das Promise mit einem TypeError abgelehnt. Wenn du einen Body-Stream zweimal lesen musst, rufe vor dem ersten Lesen response.clone() auf.

Die Methode puffert den gesamten Body, daher solltest du den Speicherverbrauch berücksichtigen. Sie prüft nicht response.ok. Dies ist eine durch den Fetch Standard definierte Web API und kein ECMAScript-Feature.

Beispiele

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

Ergebnis

Cześć!
true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen