TextDecoder()

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

如果 utfLabel 值是未知的,或是使用了“replacement”编码(“iso-2022-cn”或“iso-2022-cn-ext”)的两个值之一,则会抛出 RangeError

语法

new TextDecoder()
new TextDecoder(utfLabel)
new TextDecoder(utfLabel, options)

参数

utfLabel 可选

一个字符串,默认是 "utf-8",包含编码器的 label 。可以是任意有效的编码

options 可选

一个具有属性的 TextDecoderOptions 对象:

fatal

一个 Boolean,表示当遇到一个编码错误时,TextDecoder.decode() 方法是否必须抛出 TypeError。默认是 false

示例

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

规范

Specification
Encoding
# ref-for-dom-textdecoder①

浏览器兼容性

BCD tables only load in the browser

参见