JavaScript教程：深入理解TextDecoder与TextEncoder

石玥含Lane

于 2025-06-11 09:00:18 发布

阅读量419

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.csdn.net/gitblog_00638/article/details/148574743

JavaScript教程：深入理解TextDecoder与TextEncoder

ru.javascript.info Современный учебник JavaScript 项目地址: https://gitcode.com/gh_mirrors/ru/ru.javascript.info

在JavaScript中处理二进制数据时，我们经常会遇到需要将二进制数据与文本相互转换的场景。本文将详细介绍JavaScript中的TextDecoder和TextEncoder这两个强大的工具。

TextDecoder：二进制到文本的转换

TextDecoder对象用于将二进制数据解码为文本字符串。这在处理从网络请求、文件读取等来源获取的二进制数据时特别有用。

创建TextDecoder实例

let decoder = new TextDecoder([label], [options]);

参数说明：

label：指定字符编码类型，默认为'utf-8'。其他常见编码包括：
- 'big5'（繁体中文）
- 'windows-1251'（西里尔字母）
- 'shift_jis'（日文）
- 以及其他多种编码
options：可选配置对象
- fatal：布尔值，设置为true时，遇到无效字符会抛出错误；否则（默认）会替换为特殊字符�（U+FFFD）
- ignoreBOM：布尔值，是否忽略字节顺序标记（BOM），通常不需要设置

解码方法

let str = decoder.decode([input], [options]);

参数说明：

input：要解码的二进制数据，可以是ArrayBuffer、TypedArray或DataView
options：可选配置
- stream：布尔值，设置为true时表示这是数据流的一部分，解码器会记住中间状态以便处理后续数据块

实际应用示例

基本解码：

let binaryData = new Uint8Array([72, 101, 108, 108, 111]);
console.log(new TextDecoder().decode(binaryData)); // 输出: Hello

处理中文字符：

let chineseData = new Uint8Array([228, 189, 160, 229, 165, 189]);
console.log(new TextDecoder().decode(chineseData)); // 输出: 你好

解码部分数据：

let data = new Uint8Array([0, 72, 101, 108, 108, 111, 0]);
let partialData = data.subarray(1, -1); // 获取中间部分
console.log(new TextDecoder().decode(partialData)); // 输出: Hello

TextEncoder：文本到二进制的转换

TextEncoder执行相反的操作，将字符串编码为二进制数据。需要注意的是，TextEncoder目前仅支持UTF-8编码。

创建TextEncoder实例

let encoder = new TextEncoder();

编码方法

TextEncoder提供两种编码方法：

encode(str)：返回包含编码结果的Uint8Array

let encoder = new TextEncoder();
let binaryData = encoder.encode("Hello");
console.log(binaryData); // 输出: Uint8Array [72, 101, 108, 108, 111]

encodeInto(str, destination)：将编码结果直接写入提供的Uint8Array

let encoder = new TextEncoder();
let targetArray = new Uint8Array(5);
encoder.encodeInto("Hello", targetArray);
console.log(targetArray); // 输出: Uint8Array [72, 101, 108, 108, 111]