Fetch API
The textStream() method of the Request interface returns a ReadableStream that can be used to read the contents of the request body in chunks of UTF-8.
This provides an easier mechanism for streaming the request body than piping the Request.body byte stream through a TextDecoderStream.
[!NOTE] If invoked on a
Requestwith a null body, for example a GET request,textStream()will return a valid empty stream.
Syntax
textStream()
Parameters
None.
Return value
A ReadableStream.
Exceptions
- TypeError
- : Thrown if the request body is disturbed or locked.
Examples
Reading request body content as a text stream
This example shows how to read a request body as a text stream.
We create a sample Request, obtain a ReadableStream of its body using textStream(), then read the text via a reader created using ReadableStream.getReader().
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);
Specifications
Browser compatibility
See also
- ReadableStream
- ReadableStream.getReader()
- Response.body
- Response.textStream()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
