此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

TextDecoderStream()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2022年9月⁩.

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

语法

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

参数

label

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

options 可选

一个具有属性的 TextDecoderOptions 对象:

fatal

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

示例

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

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

规范

Specification
Encoding
# ref-for-dom-textdecoderstream①

浏览器兼容性