TextEncoder 能将字符串可靠转为 UTF-8 字节序列（Uint8Array），避免 WebSocket.send() 传字符串时的隐式编码风险、代理对解析异常及二进制帧拼接难题，提升跨端兼容性与性能。
WebSocket 默认以 UTF-8 编码传输文本数据，但若后端或协议层对字节流有特殊要求（如需严格控制编码格式、处理非 UTF-8 兼容的二进制语义文本），直接发送字符串可能引发乱码或解析失败。TextEncoder 是解决这类问题的关键工具——它能将 JavaScript 字符串可靠地转为 UTF-8 字节序列（Uint8Array），确保 WebSocket.send() 发送的是符合预期的原始字节。
为什么 TextEncoder 比直接传字符串更可靠
WebSocket 的 send() 方法接受字符串、Blob、ArrayBuffer 或 TypedArray。传字符串时，浏览器自动按 UTF-8 编码；看似简单，但隐藏两个风险：
- 无法干预编码过程：比如字符串含代理对（surrogate pairs）或 BOM，浏览器行为虽标准，但某些老旧服务端解析库可能误判
- 无法与二进制帧混合统一处理：若协议要求“文本消息前 2 字节为长度头”，就必须用字节数组拼接，此时必须从字符串生成确定的 UTF-8 字节
- 避免隐式转换开销：频繁发送短文本时，显式用 TextEncoder 缓存实例比每次 new 更高效
正确使用 TextEncoder 发送 UTF-8 字节
只需三步：创建编码器、编码字符串、通过 WebSocket 发送 Uint8Array：
const encoder = new TextEncoder();
const ws = new WebSocket('wss://example.com');
ws.onopen = () => {
const message = '你好，世界！';
const uint8Array = encoder.encode(message); // → Uint8Array(15) [228, 189, 160, ...]
ws.send(uint8Array); // 直接发送字节流
};
注意：不要对 encode() 结果再做 new Uint8Array() 包装，TextEncoder.encode 已返回标准 Uint8Array；也不要用 ArrayBuffer.slice() 等额外拷贝，除非需要截断或拼接。
立即学习“前端免费学习笔记（深入）”；
配合 TextDecoder 处理返回的文本响应
若服务端也以 UTF-8 字节流返回文本（例如返回 ArrayBuffer），用 TextDecoder 解码可避免乱码：
const decoder = new TextDecoder('utf-8');
ws.onmessage = (event) => {
if (event.data instanceof ArrayBuffer) {
const uint8 = new Uint8Array(event.data);
const text = decoder.decode(uint8); // 安全还原为字符串
console.log(text);
}
};
TextDecoder 支持流式解码（stream: true），适合分片接收的大文本；而 TextEncoder 不支持流式编码，需一次性传完整字符串。
常见误区与绕过场景
以下情况无需强制用 TextEncoder：
- 纯文本通信且服务端明确只接收字符串（如标准 JSON over WS），直接 ws.send(JSON.stringify(obj)) 更简洁
- 需要发送 base64、hex 等编码后的文本，应先 encode 再转码，而非用 TextEncoder 处理已编码字符串
- 目标是发送非 UTF-8 编码（如 GBK、Shift-JIS）——TextEncoder 仅支持 UTF-8 和 UTF-16（实验性），此时需借助第三方库如 iconv-lite
不复杂但容易忽略：TextEncoder 是轻量、无依赖的原生方案，适用于绝大多数现代 WebSocket 文本字节控制需求。
