# App(Object object)

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

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

# 參數(shù)

# Object object

關(guān)于小程序前后臺(tái)的定義和小程序的運(yùn)行機(jī)制，請(qǐng)參考運(yùn)行機(jī)制章節(jié)。

# onLaunch(Object object)

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

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

# onShow(Object object)

小程序啟動(dòng)，或從后臺(tái)進(jìn)入前臺(tái)顯示時(shí)觸發(fā)。也可以使用 wx.onAppShow 綁定監(jiān)聽(tīng)。

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

# onHide()

小程序從前臺(tái)進(jìn)入后臺(tái)時(shí)觸發(fā)。也可以使用 wx.onAppHide 綁定監(jiān)聽(tīng)。

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

# onError(String error)

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

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

# onPageNotFound(Object object)

基礎(chǔ)庫(kù) 1.9.90 開(kāi)始支持，低版本需做兼容處理。

小程序要打開(kāi)的頁(yè)面不存在時(shí)觸發(fā)。也可以使用 wx.onPageNotFound 綁定監(jiān)聽(tīng)。注意事項(xiàng)請(qǐng)參考 wx.onPageNotFound。

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

示例代碼：

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

# onUnhandledRejection(Object object)

基礎(chǔ)庫(kù) 2.10.0 開(kāi)始支持，低版本需做兼容處理。

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

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

# onThemeChange(Object object)

基礎(chǔ)庫(kù) 2.11.0 開(kāi)始支持，低版本需做兼容處理。

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

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

# 示例代碼

App({
  onLaunch (options) {
    // Do something initial when launch.
  },
  onShow (options) {
    // Do something when show.
  },
  onHide (options) {
    // Do something when hide.
  },
  onError (msg) {
    console.log(msg)
  },
  globalData: 'I am global data'
})