Skip to content

WebSocket:send() 方法 ​

send() 方法通过连接发一条消息。字符串作为文本消息发送,其余几种作为二进制消息发送。

语法 ​

send(data)

参数 ​

data

要发的内容:

类型发成
字符串文本消息
Blob、ArrayBuffer、类型数组(比如 Uint8Array)二进制消息

单条消息能发多大,未在模拟器验证。

返回值 ​

Promise。消息交给网络发出后兑现为 true。它不等服务器确认:兑现不表示服务器已经收到。

Promise 被拒绝时,错误对象的 name 区分原因:

namemessage什么时候
InvalidStateErrorsend: the socket is not open连接没有打开:还在连接、正在关闭或已经结束
InvalidStateErrorsend: expects a string or a Blobdata 不是上表里的类型
NetworkError系统的错误描述发送过程中网络出错

异常 ​

不直接抛异常。出错都通过返回的 Promise 拒绝。

说明 ​

连接还没打开时调 send(),消息不会留到连上之后再发。要在连上后立刻发的内容,写进 open 的回调。

示例 ​

发文本和二进制 ​

js
const ws = new WebSocket('wss://echo.websocket.org');
ws.addEventListener('open', () => {
  ws.send('文本').then(() => console.log('已发出'));
  ws.send(new Uint8Array([1, 2, 3, 4, 5]));
});

结果:连上后先发出一条文本,输出 已发出;再发出一条 5 字节的二进制消息。

连上之前就发 ​

js
const early = new WebSocket('wss://echo.websocket.org');
early.send('too early').catch((err) => {
  console.log(err.name, err.message);
});

结果:输出 InvalidStateError send: the socket is not open。

和 Web 的差别 ​

  • 浏览器的 send() 没有返回值;这里返回 Promise。
  • 浏览器在连接没打开时调 send() 直接抛异常;这里是返回的 Promise 被拒绝。

参见 ​