TextDecoderStream: TextDecoderStream() 构造函数

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

语法

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

参数

label

一个默认值为 utf-8 的字符串。这可能是 任何有效的标签

options 可选

一个具有以下属性的对象

fatal 可选

一个布尔值,表示 TextDecoder.decode() 方法在解码无效数据时是否必须抛出 TypeError。它默认为 false,这意味着解码器将用替换字符替换畸形数据。

ignoreBOM 可选

一个布尔值,表示 字节顺序标记 是否将包含在输出中或跳过。它默认为 false,这意味着字节顺序标记将在解码时跳过,并且不会包含在解码后的文本中。

异常

RangeError

如果 label 的值未知,或者是一个会导致 'replacement' 解码算法的值("iso-2022-cn""iso-2022-cn-ext"),则抛出此异常。

示例

以下示例演示如何解码从 fetch() 调用中检索到的二进制数据。由于没有传递 label,因此数据将被解释为 UTF-8。

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

规范

规范
编码标准
# ref-for-dom-textdecoderstream①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。