抖音开放平台Logo
控制台
tt.onLazyLoadError
更新时间 2023-09-20 15:44:48
收藏
我的收藏
基础库 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 取消监听,以避免非预期的内存泄漏。
该文档是否对你的开发有所帮助?
有帮助
没帮助
点击纠错
rangeDom