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 取消监听,以避免非预期的内存泄漏。