微信小程序 小程序APP

App(Object object)

注冊小程序。接受一個 Object 參數(shù)，其指定小程序的生命周期回調(diào)等。

App() 必須在 app.js 中調(diào)用，必須調(diào)用且只能調(diào)用一次。不然會出現(xiàn)無法預期的后果。

參數(shù)

Object object

關于小程序前后臺的定義和小程序的運行機制，請參考運行機制章節(jié)。

示例代碼

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)

小程序初始化完成時觸發(fā)，全局只觸發(fā)一次。參數(shù)也可以使用 wx.getLaunchOptionsSync 獲取。

參數(shù)：與 wx.getLaunchOptionsSync 一致

onShow(Object object)

小程序啟動，或從后臺進入前臺顯示時觸發(fā)。也可以使用 wx.onAppShow 綁定監(jiān)聽。

參數(shù)：與 wx.onAppShow 一致

onHide()

小程序從前臺進入后臺時觸發(fā)。也可以使用 wx.onAppHide 綁定監(jiān)聽。

onError(String error)

小程序發(fā)生腳本錯誤或 API 調(diào)用報錯時觸發(fā)。也可以使用 wx.onError 綁定監(jiān)聽。

參數(shù)：與 wx.onError 一致

onPageNotFound(Object object)

基礎庫 1.9.90 開始支持，低版本需做兼容處理。

小程序要打開的頁面不存在時觸發(fā)。也可以使用 wx.onPageNotFound 綁定監(jiān)聽。注意事項請參考 wx.onPageNotFound。

參數(shù)：與 wx.onPageNotFound 一致

示例代碼：

App({
  onPageNotFound(res) {
    wx.redirectTo({
      url: 'pages/...'
    }) // 如果是 tabbar 頁面，請使用 wx.switchTab
  }
})

onUnhandledRejection(Object object)

基礎庫 2.10.0 開始支持，低版本需做兼容處理。

小程序有未處理的 Promise 拒絕時觸發(fā)。也可以使用 wx.onUnhandledRejection 綁定監(jiān)聽。注意事項請參考 wx.onUnhandledRejection。

參數(shù)：與 wx.onUnhandledRejection 一致

onThemeChange(Object object)

基礎庫 2.11.0 開始支持，低版本需做兼容處理。

系統(tǒng)切換主題時觸發(fā)。也可以使用 wx.onThemeChange 綁定監(jiān)聽。

參數(shù)：與 wx.onThemeChange 一致

AppObject getApp(Object object)

獲取到小程序全局唯一的 App 實例。

參數(shù)

Object object

示例代碼

// other.js
var appInstance = getApp()
console.log(appInstance.globalData) // I am global data

注意

• 不要在定義于 App() 內(nèi)的函數(shù)中，或調(diào)用 App 前調(diào)用 getApp() ，使用 this 就可以拿到 app 實例。
• 通過 getApp() 獲取實例之后，不要私自調(diào)用生命周期函數(shù)。