vue源码解析事件派发（$on、$emit、$once、$off）

本文将解析vue实例上与事件派发相关的4个方法，分别为：

• $on：监听事件
• $off：移除监听事件
• $emit：触发事件
• $once：监听事件，只监听1次

首先整体介绍下这四个方法实现的基本原理：

一、vue实例上会建立一个对象来保存全部要监听的事件：vm._events = {}

二、每当咱们要监听一个事件，就往vm._events里添加一个键值对，事件的名称做为键，一个空数组做为值。例如咱们要监听的事件名称为event1，则vm._events = {event1: []}

三、监听事件的回调函数都会添加到对应的数组中，例如咱们调用

vm.$on('event1', cb1);
vm.$on('event1', cb2);
vm.$on('event1', cb3);
复制代码

则此时vm._events={event1: [cb1, cb2, cb3]}

四、当调用移除监听事件的方法时，所作的操做为移除其对应数组里的回调函数，例如当咱们调用

vm.$off('event1', cb1);
复制代码

这时cb1就被移除了，vm._events={event1: [cb2, cb3]}

五、当咱们执行$emit触发对应事件时，所作的操做就是把该事件对应数组里的回调函数都拿出来执行一遍，例如当咱们调用

vm.$emit('event')
复制代码

这时候会取出event1对应数组里的cb2和cb3执行

六、$once表示该事件只会触发执行一次，后面在触发就没用了，例如当咱们调用：

// 用$on方法监听event2，回调函数为cb4
vm.$on('event2', cb4);

// 用$once方法监听event2，回调函数为cb5
vm.$once('event2', cb5);

// 触发event2事件，会执行cb4和cb5
vm.$emit('event2');

// 再次触发event2事件，这里只会执行cb5，不会执行cb4，cb4只会执行一次
vm.$emit('event2');
复制代码

以上即为事件派发方法的基本原理，固然这些方法还有一些稍微复杂一点的使用方式，好比

• $on(['event1', 'event2'], cb) // 监听多个事件
• $off(['event1', 'event2'], cb) // 移除多个事件
• $off() // 移除事件不传参数
• $off('event1') // 移除事件传一个参数
• $off('event1', cb) // 移除事件传两个参数
• $emit('event1', param1, param2) // 触发事件传参数

看完下面的源码解析就知道这些状况都是怎么处理的了

下面来看下vue源码里这四个方法的具体实现：

$on:

Vue.prototype.$on = function (event, fn) {
    const vm = this
    
    // 咱们传入的要监听的事件可能为数组，这时候对数组里的每一个事件再递归调用$on方法
    if (Array.isArray(event)) {
      for (let i = 0, l = event.length; i < l; i++) {
        vm.$on(event[i], fn)
      }
    } else {
    
      // 以前已经有监听event事件，则将这次监听的回调函数添加到其数组中，不然建立一个新数组并添加fn
      (vm._events[event] || (vm._events[event] = [])).push(fn)
    }
    return vm
  }
复制代码

$off:

Vue.prototype.$off = function (event, fn) {
    const vm = this
    // all
    if (!arguments.length) {
    // 若是没有传参数，则清空全部事件的监听函数
      vm._events = Object.create(null)
      return vm
    }
    
    // 若是传的event是数组，则对该数组里的每一个事件再递归调用$off方法
    if (Array.isArray(event)) {
      for (let i = 0, l = event.length; i < l; i++) {
        vm.$off(event[i], fn)
      }
      return vm
    }
    
    // 获取当前event里全部的回调函数
    const cbs = vm._events[event]
    
    // 若是不存在回调函数，则直接返回，由于没有能够移除监听的内容
    if (!cbs) {
      return vm
    }
    
    // 若是没有指定要移除的回调函数，则移除该事件下全部的回调函数
    if (!fn) {
      vm._events[event] = null
      return vm
    }
    
    // 指定了要移除的回调函数
    let cb
    let i = cbs.length
    while (i--) {
      cb = cbs[i]
      // 在事件对应的回调函数数组里面找出要移除的回调函数，并从数组里移除
      if (cb === fn || cb.fn === fn) {
        cbs.splice(i, 1)
        break
      }
    }
    return vm
  }
复制代码

$emit:

Vue.prototype.$emit = function (event) {
    const vm = this
    
    // 拿出触发事件对应的回调函数列表
    let cbs = vm._events[event]
    
    if (cbs) {
      
      // $emit方法能够传参，这些参数会在调用回调函数的时候传进去
      const args = toArray(arguments, 1)
      
      // 遍历回调函数列表，调用每一个回调函数
      for (let i = 0, l = cbs.length; i < l; i++) {
        cbs[i].apply(vm, args)
      }
    }
    return vm
  }
}
复制代码

$once:

Vue.prototype.$once = function (event, fn) {
    const vm = this
    
    // 封装一个高阶函数on，在on里面调用fn
    function on () {
      // 每当执行了一次on，移除event里的on事件，后面再触发event事件就不会再执行on事件了，也就不会执行on里面的fn事件
      vm.$off(event, on)
      
      // 执行on的时候，执行fn函数
      fn.apply(vm, arguments)
    }
    
    // 这个赋值是在$off方法里会用到的
    // 好比咱们调用了vm.$off(fn)来移除fn回调函数，然而咱们在调用$once的时候，实际执行的是vm.$on(event, on)
    // 因此在event的回调函数数组里添加的是on函数，这个时候要移除fn，咱们没法在回调函数数组里面找到fn函数移除，只能找到on函数
    // 咱们能够经过on.fn === fn来判断这种状况，并在回调函数数组里移除on函数
    on.fn = fn
    
    // $once最终调用的是$on，而且回调函数是on
    vm.$on(event, on)
    return vm
  }
复制代码