# TCPSocket.onMessage(function listener)

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

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

## 功能描述

监听当接收到数据的时触发该事件

## 参数

### function listener

当接收到数据的时触发该事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "message",
    "类型": "ArrayBuffer",
    "说明": "收到的消息"
  },
  {
    "属性": "remoteInfo",
    "类型": "Object",
    "说明": "发送端地址信息",
    "子项": [
      {
        "结构属性": "address",
        "类型": "string",
        "说明": "发送消息的 socket 的地址"
      },
      {
        "结构属性": "family",
        "类型": "string",
        "说明": "使用的协议族，为 IPv4 或者 IPv6"
      },
      {
        "结构属性": "port",
        "类型": "number",
        "说明": "端口号"
      }
    ]
  },
  {
    "属性": "localInfo",
    "类型": "Object",
    "说明": "接收端地址信息",
    "子项": [
      {
        "结构属性": "address",
        "类型": "string",
        "说明": "接收消息的 socket 的地址"
      },
      {
        "结构属性": "family",
        "类型": "string",
        "说明": "使用的协议族，为 IPv4 或者 IPv6"
      },
      {
        "结构属性": "port",
        "类型": "number",
        "说明": "端口号"
      }
    ]
  }
]
```