Methode textStream()

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Vollständige Kompatibilität anzeigen
Mehr erfahren

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