tt.onLazyLoadError

收藏
我的收藏
基础库 2.86.1 开始支持本方法,低版本需做兼容处理,这是一个同步方法。​
监听小程序异步组件加载失败事件。​

语法​

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