注册小程序。接受一个 object 参数,其指定小程序的生命周期回调等
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
onLaunch | function | 生命周期回调——监听小程序初始化。 | ||
onShow | function | 生命周期回调——监听小程序启动或切前台。 | ||
onHide | function | 生命周期回调——监听小程序切后台。 | ||
onError | function | 错误监听函数。 | ||
onPageNotFound | function | 页面不存在监听函数。 | ||
onUnhandledRejection | function | 未处理的 Promise 拒绝事件监听函数。 | ||
其他 | any | 开发者可以添加任意的函数或数据变量到 object 参数中,用 this 可以访问 |
小程序初始化完成时触发,全局只触发一次。参数也可以使用
参数:与
Object 启动参数
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
path | string | 启动小程序的路径 (代码包路径) | - |
scene | number | 启动小程序的场景值 | - |
query | Record.<string, string> | 启动小程序的 query 参数 | - |
shareTicket | string | shareTicket,详见获取更多转发信息 | 3.108.x |
小程序启动,或从后台进入前台显示时触发。
参数:与
Object 启动参数
属性 | 类型 | 说明 | 最低版本 |
---|---|---|---|
path | string | 启动小程序的路径 (代码包路径) | - |
scene | number | 启动小程序的场景值 | - |
query | Record.<string, string> | 启动小程序的 query 参数 | - |
shareTicket | string | shareTicket,详见获取更多转发信息 | 3.108.x |
小程序从前台进入后台时触发。
小程序发生脚本错误或 API 调用报错时触发。也可以使用 xhs.onError 绑定监听
参数:与 [xhs.onError]( 一致
小程序要打开的页面不存在时触发。也可以使用 xhs.onPageNotFound 绑定监听。注意事项请参考 xhs.onPageNotFound。
参数:与 xhs.onPageNotFound 一致
示例代码:
App({ onPageNotFound(res) { xhs.redirectTo({ url: 'pages/...' }) // 如果是 tabbar 页面,请使用 xhs.switchTab } })
小程序有未处理的 Promise 拒绝时触发。也可以使用 xhs.onUnhandledRejection 绑定监听。注意事项请参考 xhs.onUnhandledRejection。
参数:与 xhs.onUnhandledRejection 一致
App({ onLaunch (options) { // Do something initial when launch. }, onShow (options) { // Do something when show. }, onHide () { // Do something when hide. }, onError (msg) { console.log(msg) }, globalData: 'I am global data' })