3.1 小程序app
App(Objectobject)
注册小程序。接受一个Object参数,其指定小程序的生命周期回调等。
App()必须在app.js中调用,必须调用且只能调用一次。不然会出现无法预期的后果。
属性 | 类型 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|
onLaunch | function | 否 | 生命周期回调——监听小程序初始化。 | |
onShow | function | 否 | 生命周期回调——监听小程序启动或切前台。 | |
onHide | function | 否 | 生命周期回调——监听小程序切后台。 | |
onError | function | 否 | 错误监听函数。 | |
onPageNotFound | function | 否 | 页面不存在监听函数。 | 1.9.90 |
onUnhandledRejection | function | 否 | 未处理的Promise拒绝事件监听函数。 | 2.10.0 |
onThemeChange | function | 否 | 监听系统主题变化 | 2.11.0 |
其他 | any | 否 | 开发者可以添加任意的函数或数据变量到Object 参数中,用this 可以访问 |
关于小程序前后台的定义和小程序的运行机制,请参考运行机制章节。
p>示例代码App({
onLaunch(options){
//Dosomethinginitialwhenlaunch.
},
onShow(options){
//Dosomethingwhenshow.
},
onHide(){
//Dosomethingwhenhide.
},
onError(msg){
console.log(msg)
},
globalData:'I am global data'
})
以下是小程序事件按照常用程度排序:
onLaunch(Objectobject)
小程序初始化完成时触发,全局只触发一次。参数也可以使用wx.getLaunchOptionsSync获取。
参数:与wx.getLaunchOptionsSync一致
onShow(Objectobject)
小程序启动,或从后台进入前台显示时触发。也可以使用wx.onAppShow绑定监听。
参数:与wx.onAppShow一致
onHide()
小程序从前台进入后台时触发。也可以使用wx.onAppHide绑定监听。
onError(Stringerror)
小程序发生脚本错误或API调用报错时触发。也可以使用wx.onError绑定监听。
参数:与wx.onError一致
onPageNotFound(Objectobject)
小程序要打开的页面不存在时触发。也可以使用wx.onPageNotFound绑定监听。注意事项请参考wx.onPageNotFound。
参数:与wx.onPageNotFound一致
示例代码:
App({
onPageNotFound(res){
wx.redirectTo({
url:'pages/...'
})
//如果是tabbar页面,请使用wx.switchTab
}
})
onUnhandledRejection(Objectobject)
基础库2.10.0开始支持,低版本需做兼容处理。
小程序有未处理的Promise拒绝时触发。也可以使用wx.onUnhandledRejection绑定监听。注意事项请参考wx.onUnhandledRejection。
参数:与wx.onUnhandledRejection一致
onThemeChange(Objectobject)
系统切换主题时触发。也可以使用wx.onThemeChange绑定监听。
参数:与wx.onThemeChange一致