Version: next
SocketTask
WebSocket 任务，可通过 Taro.connectSocket() 接口创建返回。
方法
| 参数 | 类型 | 说明 |
|---|---|---|
| socketTaskId | number | websocket 当前的连接 ID。 |
| readyState | number | websocket 当前的连接状态。 |
| errMsg | string | websocket 接口调用结果。 |
| CONNECTING | number | websocket 状态值：连接中。 |
| OPEN | number | websocket 状态值：已连接。 |
| CLOSING | number | websocket 状态值：关闭中。 |
| CLOSED | number | websocket 状态值：已关闭。 |
| ws | WebSocket | 浏览器 websocket 实例。（h5 端独有） |
close
关闭 WebSocket 连接
(option: CloseOption) => void
| 参数 | 类型 |
|---|---|
| option | CloseOption |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.close | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
onClose
监听 WebSocket 连接关闭事件
(callback: OnCloseCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OnCloseCallback | WebSocket 连接关闭事件的回调函数 |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.onClose | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
onError
监听 WebSocket 错误事件
(callback: OnErrorCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OnErrorCallback | WebSocket 错误事件的回调函数 |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.onError | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
onMessage
监听 WebSocket 接受到服务器的消息事件
<T = any>(callback: OnMessageCallback<T>) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | T | WebSocket 接受到服务器的消息事件的回调函数 |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.onMessage | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
onOpen
监听 WebSocket 连接打开事件
(callback: OnOpenCallback) => void
| 参数 | 类型 | 说明 |
|---|---|---|
| callback | OnOpenCallback | WebSocket 连接打开事件的回调函数 |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.onOpen | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
send
通过 WebSocket 连接发送数据
(option: SendOption) => void
| 参数 | 类型 |
|---|---|
| option | SendOption |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.send | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
参数
CloseOption
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | 否 | 一个数字值表示关闭连接的状态号，表示连接被关闭的原因。 |
| complete | (res: CallbackResult) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| fail | (res: CallbackResult) => void | 否 | 接口调用失败的回调函数 |
| reason | string | 否 | 一个可读的字符串，表示连接被关闭的原因。这个字符串必须是不长于 123 字节的 UTF-8 文本（不是字符）。 |
| success | (res: CallbackResult) => void | 否 | 接口调用成功的回调函数 |
OnCloseCallback
WebSocket 连接关闭事件的回调函数
(result: OnCloseCallbackResult) => void
| 参数 | 类型 |
|---|---|
| result | OnCloseCallbackResult |
OnCloseCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| code | number | 一个数字值表示关闭连接的状态号，表示连接被关闭的原因。 |
| reason | string | 一个可读的字符串，表示连接被关闭的原因。 |
OnErrorCallback
WebSocket 错误事件的回调函数
(result: OnErrorCallbackResult) => void
| 参数 | 类型 |
|---|---|
| result | OnErrorCallbackResult |
OnErrorCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| errMsg | string | 错误信息 |
OnMessageCallback
WebSocket 接受到服务器的消息事件的回调函数
(result: OnMessageCallbackResult<T>) => void
| 参数 | 类型 |
|---|---|
| result | OnMessageCallbackResult<T> |
OnMessageCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| data | T | 服务器返回的消息 |
OnOpenCallback
WebSocket 连接打开事件的回调函数
(result: OnOpenCallbackResult) => void
| 参数 | 类型 |
|---|---|
| result | OnOpenCallbackResult |
OnOpenCallbackResult
| 参数 | 类型 | 说明 |
|---|---|---|
| header | Record<string, any> | 连接成功的 HTTP 响应 Header |
SendOption
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data | string | ArrayBuffer | 是 | 需要发送的内容 |
| complete | (res: CallbackResult) => void | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| fail | (res: CallbackResult) => void | 否 | 接口调用失败的回调函数 |
| success | (res: CallbackResult) => void | 否 | 接口调用成功的回调函数 |
API 支持度
| API | 微信小程序 | 百度小程序 | 支付宝小程序 | H5 | React Native |
|---|---|---|---|---|---|
| SocketTask.close | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| SocketTask.onClose | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| SocketTask.onError | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| SocketTask.onMessage | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| SocketTask.onOpen | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |
| SocketTask.send | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ |