# [SocketTask](SocketTask.html) qa.connectSocket(Object object)

创建新的WebSocket连接

## 参数

### Object object

| 属性 | 类型 | <div style="width: 50px">默认值</div> | <div style="width: 50px">必填</div> | 说明 |
| --- | --- | --- | --- | --- |
| url | string |  | 是 | 服务器 wss 接口地址 |  |
| header | Object |  | 否 | HTTP Header，不支持 Referer |  |
| protocols | Array.\<string> |  | 否 | 子协议数组 |  |
| success | function |  | 否 | 接口调用成功的回调函数 |  |
| fail | function |  | 否 | 接口调用失败的回调函数 |  |
| complete | function |  | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |  |

## 返回值

### [SocketTask](SocketTask.html)

WebSocket任务

## 并发数

最多可以同时存在5个WebSocket连接，超过之后会默认创建失败。

## 示例代码

```js
qa.connectSocket({
  url: 'wss://example.quickapp.cn',
  header: {
    'content-type': 'application/json'
  },
  protocols: ['protocol1'],
  method: 'GET'
})
```
