# TCPSocket.onConnect(function listener)

> __小程序插件__：不支持
> 
> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [网络使用说明](/miniprogram/dev/framework/ability/network.md)

## 功能描述

监听当一个 socket 连接成功建立的时候触发该事件

## 参数

### function listener

当一个 socket 连接成功建立的时候触发该事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "useHttpDNS",
    "类型": "boolean",
    "说明": "本次连接是否使用了 HttpDNS",
    "最低版本": "[3.4.0](1003706)"
  },
  {
    "属性": "exception",
    "类型": "Object",
    "说明": "网络请求过程中的一些异常信息（例如：TCPSocket.connect 传了 enableHttpDNS: true，但最终未使用 HttpDNS 时，exception 就会说明未使用 HttpDNS 的原因）",
    "最低版本": "[3.4.0](1003706)",
    "子项": [
      {
        "结构属性": "reasons",
        "类型": "Array.<Object>",
        "说明": "异常信息",
        "最低版本": "[3.4.0](1003706)",
        "子项": [
          {
            "结构属性": "errMsg",
            "类型": "string",
            "说明": "错误原因"
          },
          {
            "结构属性": "errno",
            "类型": "string",
            "说明": "错误码"
          }
        ]
      }
    ]
  },
  {
    "属性": "remoteInfo",
    "类型": "Object",
    "说明": "发送端地址信息（目前仅iOS和Android端支持）",
    "最低版本": "[3.4.1](1003706)",
    "子项": [
      {
        "结构属性": "address",
        "类型": "string",
        "说明": "发送消息的 socket 的地址",
        "最低版本": "[3.4.1](1003706)"
      },
      {
        "结构属性": "family",
        "类型": "string",
        "说明": "使用的协议族，为 IPv4 或者 IPv6",
        "最低版本": "[3.4.1](1003706)"
      },
      {
        "结构属性": "port",
        "类型": "number",
        "说明": "端口号",
        "最低版本": "[3.4.1](1003706)"
      }
    ]
  },
  {
    "属性": "localInfo",
    "类型": "Object",
    "说明": "接收端地址信息（目前仅iOS和Android端支持）",
    "最低版本": "[3.4.1](1003706)",
    "子项": [
      {
        "结构属性": "address",
        "类型": "string",
        "说明": "接收消息的 socket 的地址",
        "最低版本": "[3.4.1](1003706)"
      },
      {
        "结构属性": "family",
        "类型": "string",
        "说明": "使用的协议族，为 IPv4 或者 IPv6",
        "最低版本": "[3.4.1](1003706)"
      },
      {
        "结构属性": "port",
        "类型": "number",
        "说明": "端口号",
        "最低版本": "[3.4.1](1003706)"
      }
    ]
  }
]
```