Node.js TextDecoder

2025 年 5 月 7 日 | 阅读 4 分钟

Node.js 中的 TextDecoder 类非常有助于解析可能包含 Buffer、Uint8Array 或其他类型数据的二进制原始数据，将其转换为人们易于阅读和理解的纯文本数据。它是 util 模块的一部分，并实现了 Encoding Standard，为 UTF-8、UTF-16、ISO-8859-1 等各种字符编码的文本数据提供了强大的解码支持。

在当前应用程序场景中处理数据时，文本数据通常以二进制形式存储或传输，例如文件、API、流 IO 或设备。在这种情况下，借助 TextDecoder 类，可以很好地满足管理此数据、代码格式并将其转换回字符串，同时保留编码字符串形式的问题。基本的转换方法，例如 Buffer.toString() 函数，不像 TextDecoder 那样提供灵活的编码行为、错误报告和字节顺序标记。

语法

TextDecoder 类用法概述语法是：

 
const { TextDecoder } = require('util');
const decoder = new TextDecoder([encoding], [options]);   

参数

编码

encoding 参数指定用于解码二进制数据的字符集。可能的值包括：

'utf-8' (默认): 支持所有 Unicode 字符的通用字符编码。
'utf16le': 小端 UTF-16 编码。
'iso-8859-1': 用于西欧语言的单字节编码。

其他支持的编码：'latin1'、'ascii'、'utf-16be' 等。

选项

Options 配置解码器的行为。这些选项包括：

fatal (boolean): 如果为 true，解码器将为无效字节序列抛出错误，而不是用备用字符替换它们。默认为 false。
ignoreBOM (boolean): 如果为 true，则在解码过程中忽略字节顺序标记 (BOM)。默认为 false。

示例及输出

示例 1：解码 UTF-8 数据

 
const { TextDecoder } = require('util');
 
const buffer = new Uint8Array([72, 101, 108, 108, 111]);
const decoder = new TextDecoder('utf-8');
const text = decoder.decode(buffer);
 
console.log(text);    

输出

 
Hello

示例 2：使用备用字符处理无效序列

 
const { TextDecoder } = require('util');
 
const buffer = new Uint8Array([0xC3, 0x28]); // Invalid UTF-8 sequence
const decoder = new TextDecoder('utf-8');
const text = decoder.decode(buffer);
 
console.log(text);    

输出

 
Text

示例 3：使用 fatal 选项

 
const { TextDecoder } = require('util');
 
const buffer = new Uint8Array([0xC3, 0x28]); // Invalid UTF-8 sequence
const decoder = new TextDecoder('utf-8', { fatal: true });
 
try {
  const text = decoder.decode(buffer);
} catch (error) {
  console.error(error.message); }   

输出

 
The encoded data was not valid for the encoding

示例 4：解码 UTF-16 数据

 
const { TextDecoder } = require('util');
 
const buffer = new Uint16Array([0x0068, 0x0069]);
const decoder = new TextDecoder('utf-16le');
const text = decoder.decode(buffer);
 
console.log(text);    

输出

hi