抖音开放平台Logo
控制台

tt.onLazyLoadError

更新时间 2024-07-24 02:58:49
收藏
我的收藏
​基础库 2.86.1 开始支持本方法，低版本需做兼容处理，这是一个同步方法。​
监听小程序异步组件加载失败事件。​

​语法​

js
复制
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​

​返回值​

无​

​代码示例​

开发者工具中预览​
js
复制
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 取消监听，以避免非预期的内存泄漏。​
​