TextDecoder:TextDecoder() 建構函式

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

注意:此功能在 Web Workers 中可用。

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");
// Throws a RangeError exception.

規範

規範
編碼
# ref-for-dom-textdecoder①

瀏覽器相容性

另見