Anfrage: textStream() Methode
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die textStream()-Methode des Request-Interfaces gibt einen ReadableStream zurück, der verwendet werden kann, um den Inhalt des Anfragekörpers in UTF-8-Chunks zu lesen.
Dies bietet einen einfacheren Mechanismus zum Streamen des Anfragekörpers als das Piping des Request.body-Bytestreams durch einen TextDecoderStream.
Hinweis:
Wenn sie auf einem Request mit einem Nullkörper aufgerufen wird, zum Beispiel bei einer GET-Anfrage, gibt textStream() einen gültigen leeren Stream zurück.
Syntax
textStream()
Parameter
Keine.
Rückgabewert
Ein ReadableStream.
Ausnahmen
TypeError-
Wird ausgelöst, wenn der Anfragekörper gestört oder gesperrt ist.
Beispiele
Lesen des Inhalts des Anfragekörpers als Textstream
Dieses Beispiel zeigt, wie man einen Anfragekörper als Textstream liest.
Wir erstellen eine Beispiel-Request, erhalten einen ReadableStream ihres Körpers mit textStream() und lesen dann den Text über einen Leser, der mit ReadableStream.getReader() erstellt wurde.
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);
Spezifikationen
| Spezifikation |
|---|
| Fetch # dom-body-textstream |