TextDecoderStream()

基线

广泛可用

自 2022年9月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

TextDecoderStream() 构造函数创建一个新的 TextDecoderStream 对象，该对象用于将二进制编码的文本流转换为字符串。

语法

new TextDecoderStream(label)
new TextDecoderStream(label, options)

默认为 utf-8 的字符串。可以是任意有效的编码。

一个具有属性的 TextDecoderOptions 对象：

fatal: 一个布尔值，表示错误的模式。如果是 true，则在 decoder 遇到错误时抛出一个 DOMException。默认值是 false。

以下示例演示如何从一个 fetch() 中获取并解码二进制数据。如果没有传递任何 label，数据的解码类型为 UTF-8。

const response = await fetch("https://example.com");
const stream = response.body.pipeThrough(new TextDecoderStream());

规范
Encoding> # ref-for-dom-textdecoderstream①>

此页面最后更新于 2025年6月24日，由 MDN 贡献者更新。