小程序技能进阶回忆录 - 如何改变 onLoad 的执行时机

人活着，总得要点英雄主义的，哪怕失败、死亡。

也许在小程序全部生命周期里，咱们用的最多的就是 onLoad，一大堆代码都要在初始化的时候执行。

不少时候，初始化的代码是每一个页面共用的，好比获取用户信息、获取定位等：

Page({
  onLoad() {
    this.userData = getUserData()
    wx.getLocation({
      type: 'wgs84',
      success (res) {
        // 业务代码
        // ...
      }
    })
  }
  // ...
})

长此以往，每一个页面的 js 里都是如上的重复代码。若是能够先执行完通用的初始化代码，再执行每一个页面各自的 onLoad 多好，惋惜小程序并无提供相似的钩子函数，那就本身来吧。

代理 onLoad

按照前几篇的方法，能够代理原有的 onLoad 事件：

var originPage = Page

function MyPage(config) {
  this.lifetimeBackup = {
    onLoad: config.onLoad
  }
  config.onLoad = function(options) {
    // 自定义代码
    // 公共的初始化代码
    this.userData = getUserData()
     wx.getLocation({
      type: 'wgs84',
      success (res) {
        // 执行 onLoad
        this.lifetimeBackup.onLoad.call(this, options)
      }
    })
  }
  
  // ...

  originPage(config)
}

固然，实际开发过程当中的初始化代码不可能这么少，能够用不少方式把它抽离出去，好比这样：

// utils/initial.js
function initial(callback) {
  this.userData = getUserData()
  wx.getLocation({
    type: 'wgs84',
    success (res) {
      callback()
    }
  })
}
  
// utils/wx.js
var initial = require('./initial')
var originPage = Page

function MyPage(config) {
  this.lifetimeBackup = {
    onLoad: config.onLoad
  }
  config.onLoad = function(options) {
    initial(() => {
      this.lifetimeBackup.onLoad.call(this, options)
    })
  }
  // ...
  originPage(config)
}

也可使用更多高级的方法抽离出去，好比 event bus 之类的，就很少赘述。

看似很简单，但其实这样忽略了一个问题 —— 生命周期顺序被打乱了！若是初始化方法里有异步代码，那首先执行的可能就是 onShow ，而不是约定的 onLoad。

恢复生命周期顺序

为了保证生命周期函数可以按顺序执行，能够先临时清空生命周期函数，而后再依次执行，以下代码所示：

// utils/wx.js
const LIFETIME_EVENTS = ['onLoad', 'onShow', 'onReady']
var initial = require('./initial')
var originPage = Page


function MyPage(config) {
  LIFETIME_EVENTS.forEach((event) => {
    // 备份生命周期函数
    this.lifetimeBackup[event] = config[event]
    // 临时清空
    config[event] = function() {}
  })
  config.onLoad = function(options) {
    initial(() => {
      // 依次执行生命周期函数
      LIFETIME_EVENTS.forEach((event) => {
        this.lifetimeBackup[event].call(this, options)
      })
    })
  }
  // ...
  originPage(config)
}

注意上述代码仍是有问题的，当小程序业务跳走再返回或者切后台到前台时，onShow 没法正常触发，由于被设置为空函数了。

为了保证 onShow 等生命周期函数的后续正常运行，须要在依次执行完生命周期函数后，再把它们恢复到 config 下，这是必不可少的。完整代码以下：

// utils/wx.js
const LIFETIME_EVENTS = ['onLoad', 'onShow', 'onReady']
var initial = require('./initial')
var originPage = Page


function MyPage(config) {
  LIFETIME_EVENTS.forEach((event) => {
    // 备份生命周期函数
    this.lifetimeBackup[event] = config[event]
    // 临时清空
    config[event] = function() {}
  })
  config.onLoad = function(options) {
    initial(() => {
      // 依次执行生命周期函数
      LIFETIME_EVENTS.forEach((event) => {
        this.lifetimeBackup[event].call(this, options)
        // 执行完后，恢复过来
        config[event] = this.lifetimeBackup[event]
      })
    })
  }
  // ...
  originPage(config)
}

总结

代理了 onLoad 后，就能够手动控制其执行的时机，能够折腾的事情就多了不少。好比当初始化函数须要执行（请求）的内容比较多，耗时比较长时，能够统一给页面增长一些 loading 提示等。总之，能够自由控制了。