当前位置:首页 > 文章列表 > 文章 > 前端 > WebSocket binaryType 怎样决定二进制消息的返回类型

WebSocket binaryType 怎样决定二进制消息的返回类型

来源:17golang原创 2026-11-17 01:22:26 0浏览 收藏

在前端接 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 对象选择,不负责把文本转成二进制,也不改变服务端发出的帧类型。

WebSocket 文本帧、二进制帧和 binaryType 返回类型关系说明图
图1:WebSocket 文本帧、二进制帧和 binaryType 返回类型的静态说明图。

因此,先记住下面这张小表:

消息类型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。

WebSocket event.data 到 Blob、ArrayBuffer 和字节视图的关系说明图
图2:从 event.data 到 Blob、ArrayBuffer 和字节视图的静态关系图。
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 就假定第一个字节一定是版本号。

文本帧、二进制帧和类型判断的边界

排查时可以按三个问题缩小范围:

  1. 服务端发送的是文本帧还是二进制帧?如果是文本帧,先按字符串协议处理。
  2. 客户端是否在消息到达前把 binaryType 设置成了目标值?没有设置时,浏览器默认使用 blob。
  3. 解析器是否与 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 后再创建字节视图。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
CSS ruby-position 怎样控制注音标记的位置CSS ruby-position 怎样控制注音标记的位置
上一篇
CSS ruby-position 怎样控制注音标记的位置
IndexedDB getAll 怎样限制查询数量并保留键范围
下一篇
IndexedDB getAll 怎样限制查询数量并保留键范围
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1057次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1059次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1223次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1165次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1009次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码