# wx.onLazyLoadError(function listener)

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

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

> 相关文档: [分包异步化](/miniprogram/dev/framework/subpackages/async.md)

## 功能描述

监听小程序异步组件加载失败事件。

## 参数

### function listener

小程序异步组件加载失败事件的监听函数

#### 参数

##### Object res

| 属性 | 类型 | 说明 |
| ---- | ---- | ---- |
| type  | string | 'subpackage' 失败类型 |
| subpackage  | Array | 异步组件所属的分包 |
| errMsg  | string | 详细信息 |

## 注意

- 加载异步组件通常需要下载分包，若分包下载超时，则会触发 errMsg 为 "loadSubpackage: timeout" 的回调，默认超时等待时间为 10 秒。
- 可以通过第二个参数指定超时时间（单位：ms），该设置全局有效，多次指定超时时间则覆盖前面。
- 分包确认下载失败时，会再次触发 errMsg 为 "loadSubpackage: fail" 的回调。
- 若在页面中使用该接口进行监听，请确保在必要时手动调用 offLazyLoadError 取消监听，以避免非预期的内存泄漏。