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() der Schnittstelle Request gibt einen ReadableStream zurück, der verwendet werden kann, um den Inhalt des Request-Bodys stückweise als UTF-8 zu lesen.

Dies bietet einen einfacheren Mechanismus zum Streamen des Request-Bodys, als den Bytestream Request.body durch einen TextDecoderStream zu leiten.

Hinweis: Wenn textStream() bei einem Request mit einem null-Body aufgerufen wird, beispielsweise bei einer GET-Request, gibt textStream() einen gültigen leeren Stream zurück.

Syntax

textStream()

Ausnahmen

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

Beispiele

Inhalte des Request-Bodys als Textstream lesen

Dieses Beispiel zeigt, wie ein Request-Body als Textstream gelesen wird.

Wir erstellen einen Beispiel-Request, rufen mithilfe von textStream() einen ReadableStream seines Bodys ab und lesen anschließend den Text über einen mit ReadableStream.getReader() erstellten Reader.

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

const req = new Request("https://example.com", {
  method: "POST",
  body: '{"hello": "world"}',
});

async function streamRequestText(request) {
  const textStream = request.textStream();
  // instead of
  // const textStream = request.body.pipeThrough(new TextDecoderStream());

  const reader = textStream.getReader();

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

streamRequestText(req);