# wx.onSocketMessage(function listener)

推荐使用 [SocketTask](/miniprogram/dev/api/network/websocket/SocketTask) 的方式去管理 webSocket 链接，每一条链路的生命周期都更加可控，同时存在多个 webSocket 的链接的情况下使用 wx 前缀的方法可能会带来一些和预期不一致的情况。

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

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

## 功能描述

监听 WebSocket 接收到服务器的消息事件。

## 参数

### function listener

WebSocket 接收到服务器的消息事件的监听函数

#### 参数

##### Object res

| 属性 | 类型 | 说明 |
| ---- | ---- | ---- |
| data  | string/ArrayBuffer | 服务器返回的消息 |