# wx.onBeaconUpdate(function listener)

> 基础库 1.2.0 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：支持，需要小程序基础库版本不低于 [1.9.6](1003706)
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [蓝牙信标 (Beacon)](/miniprogram/dev/framework/device/beacon.md)

## 功能描述

监听 Beacon 设备更新事件，仅能注册一个监听

## 参数

### function listener

Beacon 设备更新事件的监听函数

#### 参数

##### Object res

| 属性 | 类型 | 说明 |
| ---- | ---- | ---- |
| beacons  | Array.<[BeaconInfo](/miniprogram/dev/api/device/ibeacon/BeaconInfo)> | 当前搜寻到的所有 Beacon 设备列表 |

## 示例代码

```js
wx.onBeaconUpdate(res => {
   console.log(res.beacons)
})
```