
创建一个 WebSocket 连接。
基础库 1.7.0 之前,一个微信小程序同时只能有一个 WebSocket 连接,如果当前已存在一个 WebSocket 连接,会自动关闭该连接,并重新创建一个 WebSocket 连接。基础库版本 1.7.0 及以后,支持存在多个 WebSokcet 连接,每次成功调用 wx.connectSocket 会返回一个新的 SocketTask。
OBJECT参数说明:
| 参数 | 类型 | 必填 | 说明 | 最低版本 |
|---|---|---|---|---|
| url | String | 是 | 开发者服务器接口地址,必须是 wss 协议,且域名必须是后台配置的合法域名 | |
| header | Object | 否 | HTTP Header , header 中不能设置 Referer | |
| method | String | 否 | 默认是GET,有效值:OPTIONS, GET, HEAD, POST, PUT, DELETE, TRACE, CONNECT | |
| protocols | StringArray | 否 | 子协议数组 | 1.4.0 |
| success | Function | 否 | 接口调用成功的回调函数 | |
| fail | Function | 否 | 接口调用失败的回调函数 | |
| complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
示例代码:
wx.connectSocket({
url: 'wss://example.qq.com',
data: {
x: '',
y: ''
},
header: {
'content-type': 'application/json'
},
protocols: ['protocol1'],
method: "GET",
fail:function(res){
console.log('出错了');
console.log(res);
}
})