App(Object object)的作用講解
注冊小程序。接受一個 Object
參數,其指定小程序的生命周期回調等。
App() must 在 app.js
中call ,must調用且隻能調用only one。or 會出現無法預期的後果。
關于小程序前後台的定義和小程序的運行機制,請參考運行機制章節。
示例代碼
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'
})
onLaunch(Object object)
小程序初始化完成時觸發,全局隻觸發一次。參數也可以使用 wx.getLaunchOptionsSync
獲取。
參數:與 wx.getLaunchOptionsSync
一緻
onShow(Object object)
小程序啟動,或從後台進入前台顯示時觸發。也可以使用 wx.onAppShow
綁定監聽。
參數:與 wx.onAppShow
一緻
onHide()
小程序從前台進入後台時觸發。也可以使用 wx.onAppHide
綁定監聽。
onError(String error)
小程序發生腳本錯誤或 API 調用報錯時觸發。也可以使用 wx.onError
綁定監聽。
參數:與 wx.onError
一緻
參數說明
Object object
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
onLaunch | function | 不 | 生命周期回調——監聽小程序初始化。 | |
onShow | function | 不 | 生命周期回調——監聽小程序啟動或切前台。 | |
onHide | function | 不 | 生命周期回調——監聽小程序切後台。 | |
onError | function | 不 | 錯誤監聽函數。 | |
onPageNotFound | function | 不 | 頁面不存在監聽函數。 | |
其他 | any | 否 |
開發者可以添加任意的函數或數據變量到 Object 參數中,用 this 可以訪問 |
onPageNotFound(Object object)
基礎庫 1.9.90 開始支持,低版本需做兼容處理。
小程序要打開的頁面不存在時觸發。也可以使用 wx.onPageNotFound
綁定監聽。注意事項請參考 wx.onPageNotFound
。
參數:與 wx.onPageNotFound
一緻
示例代碼:
App({
onPageNotFound(res) {
wx.redirectTo({
url: 'pages/...'
}) // 如果是 tabbar 頁面,請使用 wx.switchTab
}
})