TextDecoder: TextDecoder() 构造函数

TextDecoder() 构造函数返回一个新创建的 TextDecoder 对象，用于参数中指定的编码。

语法

js
new TextDecoder()
new TextDecoder(label)
new TextDecoder(label, options)

参数

label 可选

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

options 可选

具有以下属性的对象

fatal 可选

一个布尔值，指示 TextDecoder.decode() 方法在解码无效数据时是否必须抛出 TypeError。它默认为 false，这意味着解码器将使用替换字符替换格式错误的数据。

ignoreBOM 可选

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

异常

RangeError

如果 label 的值未知，或者它会导致 'replacement' 解码算法的其中一个值（"iso-2022-cn" 或 "iso-2022-cn-ext"），则抛出此异常。

示例

js
const textDecoder1 = new TextDecoder("iso-8859-2");
const textDecoder2 = new TextDecoder();
const textDecoder3 = new TextDecoder("csiso2022kr", { fatal: true }); // Allows TypeError exception to be thrown.
const textDecoder4 = new TextDecoder("iso-2022-cn"); // Throw a RangeError exception.

规范

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

浏览器兼容性

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

另请参阅