TextDecoderStream：TextDecoderStream() 建構函式

Baseline 已廣泛支援

此功能已成熟，並可在多種裝置和瀏覽器版本上執行。自 2022 年 9 月起，所有瀏覽器都已支援此功能。

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

TextDecoderStream() 建構函式建立一個新的 TextDecoderStream 物件，該物件用於將具有二進位制編碼的文字流轉換為字串。

語法

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

一個字串，預設為 utf-8。這可以是任何有效的標籤。

具有以下屬性的物件：

fatal 可選: 一個布林值，指示在解碼無效資料時 TextDecoder.decode() 方法是否必須丟擲 TypeError。預設為 false，這意味著解碼器將用替換字元替換格式錯誤的（無效）資料。
ignoreBOM 可選: 一個布林值，指示是否將在輸出中包含位元組順序標記或跳過它。預設為 false，這意味著在解碼時將跳過位元組順序標記，並且不會將其包含在解碼後的文字中。

RangeError: 如果 label 的值未知，或者其值導致了 'replacement' 解碼演算法（"iso-2022-cn" 或 "iso-2022-cn-ext"），則會丟擲此異常。

以下示例演示瞭如何解碼從 fetch() 呼叫中檢索到的二進位制資料。由於未傳遞 label，因此資料將按 UTF-8 進行解釋。

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

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

此頁面最後修改於 ⁨2025 年 6 月 23 日⁩，由 MDN 貢獻者修改。