tt.onLazyLoadError
收藏监听小程序异步组件加载失败事件。
语法
tt.onLazyLoadError(listener, time);
参数说明
listener
类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
function | | 是 | 小程序异步组件加载失败事件的监听函数 | 2.86.1 |
回调函数(listener) 参数说明
object 类型，属性如下：
属性名 | 类型 | 说明 | 最低支持版本 |
type | string | 'subpackage' 失败类型 | 2.86.1 |
subpackage | array | 异步组件所属的分包 | 2.86.1 |
errMsg | string | 详细信息 | 2.86.1 |
time类型说明
类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
number | 5000 | 否 | 分包下载超时时间，设置后，若下载时间超出指定时长则触发监听回调，单位 ms | 2.86.1 |
返回值
无
代码示例
const listener = (res) => console.log("自定义组件下载异常", res); tt.onLazyLoadError(listener); // 移除监听 tt.offLazyLoadError(listener);
Bug & Tip
- •Tip：相关文档：分包异步化，tt.offLazyLoadError；
- •Tip：加载异步组件通常需要下载分包，若分包下载超时，则会触发 errMsg 为 "loadSubpackage: timeout" 的回调，默认超时等待时间为 5 秒；
- •Tip：可以通过第二个参数指定超时时间（单位：ms），该设置全局有效，多次指定超时时间则覆盖前面；
- •Tip：分包确认下载失败时，会再次触发 errMsg 为 "loadSubpackage: fail" 的回调；
- •Tip：若在页面中使用该接口进行监听，请确保在必要时手动调用 tt.offLazyLoadError 取消监听，以避免非预期的内存泄漏。
