websocket

发表于

错误码

状态码 名称 描述
0–999 保留段, 未使用.
1000 CLOSE_NORMAL 正常关闭; 无论为何目的而创建, 该链接都已成功完成任务.
1001 CLOSE_GOING_AWAY 终端离开, 可能因为服务端错误, 也可能因为浏览器正从打开连接的页面跳转离开.
1002 CLOSE_PROTOCOL_ERROR 协议错误而中断连接.
1003 CLOSE_UNSUPPORTED 由于接收到不允许的数据类型而断开连接 (如仅接收文本数据的终端接收到了二进制数据).
1004 保留. 其意义可能会在未来定义.
1005 CLOSE_NO_STATUS 保留. 表示没有收到预期的状态码.
1006 CLOSE_ABNORMAL 保留. 用于期望收到状态码时连接非正常关闭 (也就是说, 没有发送关闭帧).
1007 Unsupported Data 由于收到了格式不符的数据而断开连接 (如文本消息中包含了非 UTF-8 数据).
1008 Policy Violation 由于收到不符合约定的数据而断开连接. 这是一个通用状态码, 用于不适合使用 1003 和 1009 状态码的场景.
1009 CLOSE_TOO_LARGE 由于收到过大的数据帧而断开连接.
1010 Missing Extension 客户端期望服务器商定一个或多个拓展, 但服务器没有处理, 因此客户端断开连接.
1011 Internal Error 客户端由于遇到没有预料的情况阻止其完成请求, 因此服务端断开连接.
1012 Service Restart 服务器由于重启而断开连接. [Ref]
1013 Try Again Later 服务器由于临时原因断开连接, 如服务器过载因此断开一部分客户端连接. [Ref]
1014 由 WebSocket 标准保留以便未来使用.
1015 TLS Handshake 保留. 表示连接由于无法完成 TLS 握手而关闭 (例如无法验证服务器证书).
1016–1999 由 WebSocket 标准保留以便未来使用.
2000–2999 由 WebSocket 拓展保留使用.
3000–3999 可以由库或框架使用. 不应由应用使用. 可以在 IANA 注册, 先到先得.
4000–4999 可以由应用使用.

websorket 重连

在一些运用websorket的场景里需要考虑到websorket 的重连以保证功能的正常运行. 实现如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// onerror :用于指定连接失败后的回调函数
// 建立连接失败后过一段时间重连(例如建立连接没有网络)
ws.onerror = (e) => {
      setTimeout(_ => {
         console.log('连接失败重新初始化');
        // todo 重新建立连接
      },1000)
    }
// onclose: 用于连接关闭后的回调函数
ws.onclose = res => {
    console.log('ws 已断开');
  // res.code 为上表中的错误码
  // 此时过滤掉了1000 和 1005, 其中1000为js中直接调用ws.close()的情况, 1005为后端主动断开(此处和后端确认是否需要重连)
    if (res.code != 1000 && res.code != 1005) {
        // todo 重新建立连接
    }
}

注意: 在使用websorket时一般需要定时发送一个心跳, 一方面是防止长时间无交互websocket自然断开连接, 一方面是当网络连接有问题时触发onclose关闭连接