生命周期监听,这里会在对应生命周期事件执行完成后,下次渲染前执行,说白了就是一个"after lifecycle"的钩子
APP 生命周期
对应生命周期的说明可以参考官网:传送门
监听 onLaunch 生命周期执行回调
function onLaunch(): Promise<void>
用法:
// 等待onLaunch响应完成
await testUtils.AppLifecycle.onLaunch()
程序启动,或切前台时触发
监听 onShow / componentDidShow 生命周期执行回调
function onShow(): Promise<void>
用法:
// 等待onShow响应完成
await testUtils.AppLifecycle.onShow()
程序切后台时触发
监听 onHide / componentDidHide 生命周期执行回调
function onHide(): Promise<void>
用法:
// 等待onHide响应完成
await testUtils.AppLifecycle.onHide()
小程序发生脚本错误或 API 调用报错时触发。
function onError(): Promise<Error>
用法:
// 等待onError响应完成
await testUtils.AppLifecycle.onError()
程序要打开的页面不存在时触发。
function onPageNotFound(): Promise<{ path: string; query: object; isEntryPage: boolean }>
回调参数:
属性 | 类型 | 说明 |
---|---|---|
path | string | 不存在页面的路径 |
query | Object | 打开不存在页面的 query 参数 |
isEntryPage | boolean | 是否本次启动的首个页面(例如从分享等入口进来,首个页面是开发者配置的分享页面) |
用法:
// 等待onPageNotFound响应完成
await testUtils.AppLifecycle.onPageNotFound()
小程序有未处理的 Promise 拒绝时触发。
function onUnhandledRejection(): Promise<{ reason: string; promise: Promise<unknown> }>
回调参数:
属性 | 类型 | 说明 |
---|---|---|
reason | string | 拒绝原因,一般是一个 Error 对象 |
promise | Promise | 被拒绝的 Promise 对象 |
用法:
// 等待onUnhandledRejection响应完成
await testUtils.AppLifecycle.onUnhandledRejection()
Page 生命周期
页面级别的生命周期使用方式与AppLifecycle
类似,除了用于监听的onXXX
外,页面级别的生命周期 api 还提供了triggerXXX
用于模拟触发一些特定的生命周期。
比如onReachBottom
,需要触发它的条件需要监听用户上拉触底的事件,我们写事件去模拟比较麻烦,所以我们干脆提供了triggerReachBottom
给用户在测试时可直接触发到onReachBottom
这个生命周期。
对应生命周期的说明可以参考官网:传送门
用法:
// 等待pages/index/index这个路由页面展示
await testUtils.PageLifecycle.onShow('pages/index/index')
// 手动触发onReachBottom事件
testUtils.PageLifecycle.triggerReachBottom()
// 等待onReachBottom响应完成
await testUtils.PageLifecycle.onReachBottom()
方法 | 说明 |
---|---|
onLoad(path: string) | 在此生命周期中通过访问 options 参数或调用 getCurrentInstance().router,可以访问到页面路由参数。 |
onUnload(path: string) | 在小程序环境中对应页面的 onUnload。 |
onShow(path: string) | 页面显示/切入前台时触发。 |
onHide(path: string) | 页面隐藏/切入后台时触发。 |
onReady(path: string) | 从此生命周期开始可以使用 createCanvasContext 或 createSelectorQuery 等 API 访问小程序渲染层的 DOM 节点。 |
onPullDownRefresh(path: string) | 监听用户下拉动作 |
triggerPullDownRefresh(path: string) | 触发onPullDownRefresh 生命周期 |
onReachBottom(path: string) | 监听用户上拉触底事件 |
triggerReachBottom(path: string) | 触发onReachBottom 生命周期 |
onPageScroll(path: string) | 监听用户滑动页面事件 |
triggerPageScroll(path: string, opt: PageScrollObject) | 触发onPageScroll 生命周期 |
onAddToFavorites(path: string) | 监听用户点击右上角菜单“收藏”按钮的行为,并自定义收藏内容 |
triggerAddToFavorites(path: string) | 触发onAddToFavorites 生命周期 |
onShareAppMessage(path: string) | 监听用户点击页面内转发按钮(Button 组件 openType='share')或右上角菜单“转发”按钮的行为,并自定义转发内容 |
triggerShareAppMessage(path: string, opt: ShareAppMessageObject) | 触发onShareAppMessage 生命周期 |
onShareTimeline(path: string) | 监听右上角菜单“分享到朋友圈”按钮的行为,并自定义分享内容 |
triggerShareTimeline(path: string) | 触发onShareTimeline 生命周期 |
onResize(path: string) | 监听屏幕旋转时 |
triggerResize(path: string, opt: PageResizeObject) | 触发onResize 生命周期 |
onTabItemTap(path: string) | 点击 tab 时触发 |
triggerTabItemTap(path: string, opt: TabItemTapObject) | 触发onTabItemTap 生命周期 |
onSaveExitState(path: string) | 每当小程序可能被销毁之前,页面回调函数 onSaveExitState 会被调用,可以进行退出状态的保存 |
triggerSaveExitState(path: string) | 触发onSaveExitState 生命周期 |
onTitleClick(path: string) | 点击标题触发 |
triggerTitleClick(path: string) | 触发onTitleClick 生命周期 |
onOptionMenuClick(path: string) | 点击导航栏额外图标触发 |
triggerOptionMenuClick(path: string) | 触发onOptionMenuClick 生命周期 |
onPopMenuClick(path: string) | |
triggerPopMenuClick(path: string) | 触发onPopMenuClick 生命周期 |
onPullIntercept(path: string) | 下拉截断时 onPullIntercept 触发 |
triggerPullIntercept(path: string) | 触发onPageScroll 生命周期 |