WebSocket binaryType 怎样决定二进制消息的返回类型
来源:17golang原创
时间:2026-11-17 01:22:26 221浏览 收藏
在前端接 WebSocket 二进制消息时,最容易出现的误会是:看到 message 事件,就以为 event.data 一定是字符串,或者直接把它交给 Uint8Array。真正决定二进制消息返回形态的是 WebSocket.binaryType。
官方地址:https://developer.mozilla.org/en-US/docs/Web/API/WebSocket/binaryType
结论先说清楚:binaryType 默认是 "blob",收到二进制消息时 event.data 是 Blob;改成 "arraybuffer" 后,二进制消息的 event.data 才是 ArrayBuffer。文本消息不受这个属性影响,仍然按字符串处理。
先把二进制消息的返回类型说清楚
我在接入文件预览消息时遇到过一个典型症状:服务端确实发出了二进制内容,但前端的 event.data instanceof ArrayBuffer 判断始终为假。先看消息分类,问题就比较明确了。
WebSocket 的 message 事件可以承载文本帧或二进制帧。binaryType 只参与二进制帧到达后的 JavaScript 对象选择,不负责把文本转成二进制,也不改变服务端发出的帧类型。

因此,先记住下面这张小表:
| 消息类型 | binaryType 是否影响 | event.data 的常见形态 |
|---|---|---|
| 文本帧 | 否 | 字符串 |
二进制帧 + "blob" | 是 | Blob |
二进制帧 + "arraybuffer" | 是 | ArrayBuffer |
用 blob 和 arraybuffer 选择解析入口
如果后续操作是交给文件预览、下载或 Blob URL,保留默认的 blob 更自然;如果后续要按字节读取协议头、解析定长字段或交给 TypedArray,通常在连接建立后尽早设置 arraybuffer。
const socket = new WebSocket("wss://example.test/stream");
// 让后续收到的二进制消息以 ArrayBuffer 交给 message 事件。
socket.binaryType = "arraybuffer";
socket.addEventListener("message", (event) => {
// 文本帧仍是字符串,不能因为设置 binaryType 就统一当字节处理。
if (typeof event.data === "string") {
console.log("文本消息", event.data);
return;
}
// ArrayBuffer 适合交给 TypedArray 或 DataView 做协议解析。
if (event.data instanceof ArrayBuffer) {
const bytes = new Uint8Array(event.data);
console.log("收到字节数", bytes.byteLength);
}
});
这里的关键不是把 binaryType 当成发送开关,而是让接收端提前确定数据结构。设置它之后,仍然要保证服务端发送的是二进制帧;如果服务端发送的是 JSON 文本,event.data 还是字符串。
按目标类型读取 event.data
两种选择各有对应的读取路径。Blob 更像一个带类型和大小信息的文件对象,需要通过 arrayBuffer() 转成字节缓冲区;ArrayBuffer 本身只是原始内存区域,通常再创建 Uint8Array 或 DataView。

function readBinaryMessage(data) {
// Blob 需要异步转换;ArrayBuffer 可以直接创建字节视图。
if (data instanceof Blob) {
return data.arrayBuffer().then((buffer) => {
// 用 DataView 读取协议字段时可以显式指定字节序。
const view = new DataView(buffer);
return { length: buffer.byteLength, firstByte: view.getUint8(0) };
});
}
if (data instanceof ArrayBuffer) {
// TypedArray 适合按连续字节访问,不负责解释业务字段。
const bytes = new Uint8Array(data);
return Promise.resolve({ length: bytes.byteLength, firstByte: bytes[0] });
}
// 文本或未知对象不进入二进制解析分支。
return Promise.reject(new TypeError("不是受支持的二进制消息"));
}
socket.addEventListener("message", (event) => {
if (typeof event.data !== "string") {
readBinaryMessage(event.data)
.then((result) => console.log("解析结果", result))
.catch((error) => console.error("二进制解析失败", error));
}
});
示例把“类型选择”和“字节解释”分开了:binaryType 只决定入口对象,具体字段含义仍由应用协议决定。不能因为拿到了 ArrayBuffer 就假定第一个字节一定是版本号。
文本帧、二进制帧和类型判断的边界
排查时可以按三个问题缩小范围:
- 服务端发送的是文本帧还是二进制帧?如果是文本帧,先按字符串协议处理。
- 客户端是否在消息到达前把
binaryType设置成了目标值?没有设置时,浏览器默认使用blob。 - 解析器是否与
event.data的实际类型匹配?Blob 要先转换,ArrayBuffer 才能直接创建字节视图。
还要注意,binaryType 不会提供消息背压,也不会替你拆分业务协议。它只是接收端的数据表示选择;重连、关闭码、分片协议和业务校验属于另外的设计问题。
最小检查清单
如果你的目标是按字节读取二进制协议,可以采用这组最小约定:
- 连接创建后尽早设置
socket.binaryType = "arraybuffer"。 - 在
message事件中先判断字符串,再判断ArrayBuffer。 - 把
Uint8Array用于连续字节,把DataView用于有明确偏移和字节序的字段。 - 如果选择默认的
blob,统一通过Blob.arrayBuffer()进入字节解析路径。 - 让服务端帧类型、客户端类型选择和应用层字段协议保持一致。
一句话总结:binaryType 决定的是“二进制消息到达后以什么 JavaScript 对象呈现”,不是“消息是否为二进制”。先确认帧类型,再选择 Blob 或 ArrayBuffer,最后才进入字节级解析。
相关问题
binaryType 默认是什么?
默认值是 "blob",二进制消息在 message 事件中通常以 Blob 形式出现。
设置 arraybuffer 后文本消息会变吗?
不会。文本帧仍会以字符串出现在 event.data 中。
Blob 能不能直接交给 Uint8Array?
不能把 Blob 当作 ArrayBuffer 直接使用。先调用 blob.arrayBuffer(),得到 Promise 解析出的 ArrayBuffer 后再创建字节视图。
-
130 收藏
-
311 收藏
-
447 收藏
-
493 收藏
-
156 收藏
-
250 收藏
-
325 收藏
-
149 收藏
-
文章 · 前端 | 41分钟前 | 前端 · javascript · 浏览器API · Canvas ResizeObserver devicePixelContentBoxSize device-pixel-content-box181 收藏
-
文章 · 前端 | 42分钟前 | 性能优化 · javascript · 前端开发 · root IntersectionObserver rootMargin threshold 前端可见性 rootBounds scrollMargin469 收藏
-
456 收藏
-
文章 · 前端 | 1小时前 | javascript · 异步编程 · 前端开发 · AbortController ReadableStream 流式响应 Response.Body Fetch API getReader reader.read107 收藏
-
237 收藏
-
110 收藏
-
443 收藏
-
187 收藏
-
450 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习