注册小程序。接受一个 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'
})