App(Object object)
注册小程序,每个小程序都需要在 app.js 中调用 App 方法注册小程序实例,绑定生命周期回调函数、错误监听和页面不存在监听函数等。
参数
Object object
属性 | 类型 | 描述 | 触发时机 |
---|---|---|---|
onLaunch | Function | 生命周期回调—监听小程序初始化 | 小程序初始化完成时触发(全局只触发一次) |
onShow | Function | 生命周期回调—监听小程序显示 | 小程序启动,或从后台进入前台显示时触发 |
onHide | Function | 生命周期回调—监听小程序隐藏 | 小程序从前台进入后台时触发 |
onError | Function | 错误监听函数 | 当小程序发生脚本错误,或者 api 调用失败时触发,会带上错误信息 |
onPageNotFound | Function | 页面不存在监听函数 | 小程序要打开的页面不存在时触发,会带上页面信息回调该函数 |
onUnhandledRejection | Function | 未处理的 Promise 拒绝事件监听函数。 | 逻辑代码中有未处理的 Promise rejection 会触发此回调函数 |
前台、后台定义:
小程序启动后,用户能够看到当前界面,此时小程序处于前台状态, 当用户通过右上角椭圆按钮关闭小程序或者离开 宿主 APP 时,小程序并没有立刻终止运行,而是进入了后台状态,此时会触发 onHide 回调事件。
当用户再次进入 宿主 APP 或再次打开小程序,小程序又会从后台切换至前台,此时会触发 onShow 回调事件。
如果用户长时间没有打开小程序,或者系统资源紧张,小程序可能被销毁,此时小程序会完全退出。
示例代码:
App({
onLaunch: function(options) {
console.log("launch 参数",options)
},
onShow: function(options) {
console.log("onShow 参数",options)
}
})
onLaunch(Object object)
小程序初始化完成时触发,全局仅触发一次。
参数
Object object
字段 | 类型 | 说明 |
---|---|---|
path | String | 打开小程序的路径 |
query | Object | 打开小程序的 query 字段,可通过分享或者唤起协议中配置 |
referrerInfo | Object | 由另一个小程序或其他 App 进入小程序时,返回此字段 |
referrerInfo.appId | String | 来源小程序的 appId |
referrerInfo.extraData | Object | 其他来源传过来的数据 |
onShow(Object object)
小程序启动,或从后台进入前台时触发,每次切换到前台均会触发。
onHide()
小程序从前台进入后台时触发,每次切换到后台均会触发
getApp()
获取到小程序全局唯一的 App 实例。