大网数据广告活动
Web 标准与前端开发

Request: textStream() method

· 52CE 我爱测

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.

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 Request with a null body, for example a GET request, textStream() will return a valid empty stream.

Syntax

textStream()

Parameters

None.

Return value

A ReadableStream.

Exceptions

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。