Response: Methode textStream()

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die Methode textStream() des Interfaces Response gibt einen ReadableStream zurück, der verwendet werden kann, um den Inhalt des Response-Body in UTF-8-Abschnitten zu lesen.

Dies bietet einen einfacheren Mechanismus zum Streamen des Response-Body, als den Byte-Stream Response.body durch einen TextDecoderStream zu leiten.

Hinweis: Wenn die Methode für eine Response mit einem null-Body aufgerufen wird, beispielsweise für eine 204-Response, gibt textStream() einen gültigen leeren Stream zurück.

Syntax

textStream()

Ausnahmen

TypeError: Wird ausgelöst, wenn der Response-Body gestört oder gesperrt ist.

Beispiele

Inhalte des Response-Body als Text-Stream lesen

Dieses Beispiel zeigt, wie ein Response-Body als Text-Stream gelesen wird.

Wir verwenden fetch() für eine URL, um eine Response zu erhalten, rufen mit textStream() einen ReadableStream ihres Body ab und lesen den Text anschließend über einen Reader, der mit ReadableStream.getReader() erstellt wurde.

const pElem = document.querySelector("p");

async function streamResponseText(url) {
  const response = await fetch(url);
  const textStream = response.textStream();
  // instead of
  // const textStream = response.body.pipeThrough(new TextDecoderStream());

  const reader = textStream.getReader();

  while (true) {
    const { value, done } = await reader.read();
    if (done) break;
    pElem.textContent += value;
  }
}

streamResponseText("https://www.example.com");