3.1 小程序app

App(Objectobject)
注册小程序。接受一个Object参数,其指定小程序的生命周期回调等。
App()必须在app.js中调用,必须调用且只能调用一次。不然会出现无法预期的后果。
属性类型必填说明最低版本
onLaunchfunction生命周期回调——监听小程序初始化。
onShowfunction生命周期回调——监听小程序启动或切前台。
onHidefunction生命周期回调——监听小程序切后台。
onErrorfunction错误监听函数。
onPageNotFoundfunction页面不存在监听函数。1.9.90
onUnhandledRejectionfunction未处理的Promise拒绝事件监听函数。2.10.0
onThemeChangefunction监听系统主题变化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一致