资讯专栏INFORMATION COLUMN

JavaScript EventEmitter

lovXin / 2959人阅读

摘要:事件删除可有可无。创建了一个类,然后在构造函数里初始化一个类的属性,这个属性不需要要继承任何东西,所以用了。但这不是必要的,因为实例化一个都会调用构造函数,皆为初始状态,应该是不可能已经定义了的,可去掉。成功执行结束后返回。

</>复制代码

  1. GitHub地址:JavaScript EventEmitter

    博客地址:JavaScript EventEmitter

  2. 水平有限,欢迎批评指正

2个多月前把 Github 上的 eventemitter3 和 Node.js 下的事件模块 events 的源码抄了一遍,才终于对 JavaScript 事件有所了解。

上个周末花点时间根据之前看源码的理解自己用 ES6 实现了一个 eventemitter8,然后也发布到 npm 上了,让我比较意外的是才发布两天在没有 readme 介绍,没有任何宣传的情况下居然有45个下载,我很好奇都是谁下载的,会不会用。我花了不少时间半抄半原创的一个 JavaScript 时间处理库 now.js (npm 传送门:now.js) ,在我大力宣传的情况下,4个月的下载量才177。真是有心栽花花不开,无心插柳柳成荫

eventemitter8 大部分是我根据看源码理解后写出来的,有一些方法如listenerslistenerCounteventNames 一下子想不起来到底做什么,回头重查。测试用例不少是参考了 eventemitter3,在此对 eventemitter3 的开发者们和 Node.js 事件模块的开发者们表示感谢!

下面来讲讲我对 JavaScript 事件的理解:

从上图可以看出,JavaScript 事件最核心的包括事件监听 (addListener)、事件触发 (emit)、事件删除 (removeListener)

事件监听(addListener)

首先,监听肯定要有监听的目标,或者说是对象,那为了达到区分目标的目的,名字是不可少的,我们定义为 type

其次,监听的目标一定要有某种动作,对应到 JavaScript 里实际上就是某种方法,这里定义为 fn

譬如可以监听一个 typeadd,方法为某一个变量 a 值加1的方法 fn = () => a + 1的事件。如果我们还想监听一个使变量 b2的方法,我们第一反应可能是创建一个 typeadd2,方法 为 fn1 = () => b + 2 的事件。你可能会想,这太浪费了,我能不能只监听一个名字,让它执行多于一个方法的事件。当然是可以的。

那么怎么做呢?

很简单,把监听的方法放在一个数组里,遍历数组顺序执行就可以了。以上例子变为 typeadd,方法为[fn, fn1]

如果要细分的话还可以分为可以无限次执行的事件 on 和 只允许执行一次的事件 once (执行完后立即将事件删除)。待后详述。

事件触发(emit)

单有事件监听是不够的,必须要有事件触发才能算完成整个过程。emit 就是去触发监听的特定 type 对应的单个事件或者一系列事件。拿前面的例子来说单个事件就是去执行 fn,一系列事件就是去遍历执行 fnfn1

事件删除(removeListener)

严格意义上来讲,事件监听和事件触发已经能完成整个过程。事件删除可有可无。但很多时候,我们还是需要事件删除的。比如前面讲的只允许执行一次事件 once,如果不提供删除方法,很难保证你什么时候会再次执行它。通常情况下,只要是不再需要的事件,我们都应该去删除它。

核心部分讲完,下面简单的对 eventemitter8的源码进行解析。

源码解析

全部源码:

</>复制代码

  1. const toString = Object.prototype.toString;
  2. const isType = obj => toString.call(obj).slice(8, -1).toLowerCase();
  3. const isArray = obj => Array.isArray(obj) || isType(obj) === "array";
  4. const isNullOrUndefined = obj => obj === null || obj === undefined;
  5. const _addListener = function(type, fn, context, once) {
  6. if (typeof fn !== "function") {
  7. throw new TypeError("fn must be a function");
  8. }
  9. fn.context = context;
  10. fn.once = !!once;
  11. const event = this._events[type];
  12. // only one, let `this._events[type]` to be a function
  13. if (isNullOrUndefined(event)) {
  14. this._events[type] = fn;
  15. } else if (typeof event === "function") {
  16. // already has one function, `this._events[type]` must be a function before
  17. this._events[type] = [event, fn];
  18. } else if (isArray(event)) {
  19. // already has more than one function, just push
  20. this._events[type].push(fn);
  21. }
  22. return this;
  23. };
  24. class EventEmitter {
  25. constructor() {
  26. if (this._events === undefined) {
  27. this._events = Object.create(null);
  28. }
  29. }
  30. addListener(type, fn, context) {
  31. return _addListener.call(this, type, fn, context);
  32. }
  33. on(type, fn, context) {
  34. return this.addListener(type, fn, context);
  35. }
  36. once(type, fn, context) {
  37. return _addListener.call(this, type, fn, context, true);
  38. }
  39. emit(type, ...rest) {
  40. if (isNullOrUndefined(type)) {
  41. throw new Error("emit must receive at lease one argument");
  42. }
  43. const events = this._events[type];
  44. if (isNullOrUndefined(events)) return false;
  45. if (typeof events === "function") {
  46. events.call(events.context || null, rest);
  47. if (events.once) {
  48. this.removeListener(type, events);
  49. }
  50. } else if (isArray(events)) {
  51. events.map(e => {
  52. e.call(e.context || null, rest);
  53. if (e.once) {
  54. this.removeListener(type, e);
  55. }
  56. });
  57. }
  58. return true;
  59. }
  60. removeListener(type, fn) {
  61. if (isNullOrUndefined(this._events)) return this;
  62. // if type is undefined or null, nothing to do, just return this
  63. if (isNullOrUndefined(type)) return this;
  64. if (typeof fn !== "function") {
  65. throw new Error("fn must be a function");
  66. }
  67. const events = this._events[type];
  68. if (typeof events === "function") {
  69. events === fn && delete this._events[type];
  70. } else {
  71. const findIndex = events.findIndex(e => e === fn);
  72. if (findIndex === -1) return this;
  73. // match the first one, shift faster than splice
  74. if (findIndex === 0) {
  75. events.shift();
  76. } else {
  77. events.splice(findIndex, 1);
  78. }
  79. // just left one listener, change Array to Function
  80. if (events.length === 1) {
  81. this._events[type] = events[0];
  82. }
  83. }
  84. return this;
  85. }
  86. removeAllListeners(type) {
  87. if (isNullOrUndefined(this._events)) return this;
  88. // if not provide type, remove all
  89. if (isNullOrUndefined(type)) this._events = Object.create(null);
  90. const events = this._events[type];
  91. if (!isNullOrUndefined(events)) {
  92. // check if `type` is the last one
  93. if (Object.keys(this._events).length === 1) {
  94. this._events = Object.create(null);
  95. } else {
  96. delete this._events[type];
  97. }
  98. }
  99. return this;
  100. }
  101. listeners(type) {
  102. if (isNullOrUndefined(this._events)) return [];
  103. const events = this._events[type];
  104. // use `map` because we need to return a new array
  105. return isNullOrUndefined(events) ? [] : (typeof events === "function" ? [events] : events.map(o => o));
  106. }
  107. listenerCount(type) {
  108. if (isNullOrUndefined(this._events)) return 0;
  109. const events = this._events[type];
  110. return isNullOrUndefined(events) ? 0 : (typeof events === "function" ? 1 : events.length);
  111. }
  112. eventNames() {
  113. if (isNullOrUndefined(this._events)) return [];
  114. return Object.keys(this._events);
  115. }
  116. }
  117. export default EventEmitter;

代码很少,只有151行,因为写的简单版,且用的 ES6,所以才这么少;Node.js的事件和 eventemitter3可比这多且复杂不少,有兴趣可自行深入研究。

</>复制代码

  1. const toString = Object.prototype.toString;
  2. const isType = obj => toString.call(obj).slice(8, -1).toLowerCase();
  3. const isArray = obj => Array.isArray(obj) || isType(obj) === "array";
  4. const isNullOrUndefined = obj => obj === null || obj === undefined;

这4行就是一些工具函数,判断所属类型、判断是否是 null 或者 undefined

</>复制代码

  1. constructor() {
  2. if (isNullOrUndefined(this._events)) {
  3. this._events = Object.create(null);
  4. }
  5. }

创建了一个 EventEmitter 类,然后在构造函数里初始化一个类的 _events 属性,这个属性不需要要继承任何东西,所以用了 Object.create(null)。当然这里 isNullOrUndefined(this._events) 还去判断了一下 this._events 是否为 undefined 或者 null,如果是才需要创建。但这不是必要的,因为实例化一个 EventEmitter 都会调用构造函数,皆为初始状态,this._events 应该是不可能已经定义了的,可去掉。

</>复制代码

  1. addListener(type, fn, context) {
  2. return _addListener.call(this, type, fn, context);
  3. }
  4. on(type, fn, context) {
  5. return this.addListener(type, fn, context);
  6. }
  7. once(type, fn, context) {
  8. return _addListener.call(this, type, fn, context, true);
  9. }

接下来是三个方法 addListenerononce ,其中 onaddListener 的别名,可执行多次。once 只能执行一次。

三个方法都用到了 _addListener 方法:

</>复制代码

  1. const _addListener = function(type, fn, context, once) {
  2. if (typeof fn !== "function") {
  3. throw new TypeError("fn must be a function");
  4. }
  5. fn.context = context;
  6. fn.once = !!once;
  7. const event = this._events[type];
  8. // only one, let `this._events[type]` to be a function
  9. if (isNullOrUndefined(event)) {
  10. this._events[type] = fn;
  11. } else if (typeof event === "function") {
  12. // already has one function, `this._events[type]` must be a function before
  13. this._events[type] = [event, fn];
  14. } else if (isArray(event)) {
  15. // already has more than one function, just push
  16. this._events[type].push(fn);
  17. }
  18. return this;
  19. };

方法有四个参数,type 是监听事件的名称,fn 是监听事件对应的方法,context 俗称爸爸,改变 this 指向的,也就是执行的主体。once 是一个布尔型,用来标志是否只执行一次。
首先判断 fn 的类型,如果不是方法,抛出一个类型错误。fn.context = context;fn.once = !!once 把执行主体和是否执行一次作为方法的属性。const event = this._events[type] 把该对应 type 的所有已经监听的方法存到变量 event

</>复制代码

  1. // only one, let `this._events[type]` to be a function
  2. if (isNullOrUndefined(event)) {
  3. this._events[type] = fn;
  4. } else if (typeof event === "function") {
  5. // already has one function, `this._events[type]` must be a function before
  6. this._events[type] = [event, fn];
  7. } else if (isArray(event)) {
  8. // already has more than one function, just push
  9. this._events[type].push(fn);
  10. }
  11. return this;

如果 type 本身没有正在监听任何方法,this._events[type] = fn 直接把监听的方法 fn 赋给 type 属性 ;如果正在监听一个方法,则把要添加的 fn 和之前的方法变成一个含有2个元素的数组 [event, fn],然后再赋给 type 属性,如果正在监听超过2个方法,直接 push 即可。最后返回 this ,也就是 EventEmitter 实例本身。

简单来讲不管是监听多少方法,都放到数组里是没必要像上面细分。但性能较差,只有一个方法时 key: fn 的效率比 key: [fn] 要高。

再回头看看三个方法:

</>复制代码

  1. addListener(type, fn, context) {
  2. return _addListener.call(this, type, fn, context);
  3. }
  4. on(type, fn, context) {
  5. return this.addListener(type, fn, context);
  6. }
  7. once(type, fn, context) {
  8. return _addListener.call(this, type, fn, context, true);
  9. }

addListener 需要用 call 来改变 this 指向,指到了类的实例。once 则多传了一个标志位 true 来标志它只需要执行一次。这里你会看到我在 addListener 并没有传 false 作为标志位,主要是因为我懒,但并不会影响到程序的逻辑。因为前面的 fn.once = !!once 已经能很好的处理不传值的情况。没传值 !!oncefalse

接下来讲 emit

</>复制代码

  1. emit(type, ...rest) {
  2. if (isNullOrUndefined(type)) {
  3. throw new Error("emit must receive at lease one argument");
  4. }
  5. const events = this._events[type];
  6. if (isNullOrUndefined(events)) return false;
  7. if (typeof events === "function") {
  8. events.call(events.context || null, rest);
  9. if (events.once) {
  10. this.removeListener(type, events);
  11. }
  12. } else if (isArray(events)) {
  13. events.map(e => {
  14. e.call(e.context || null, rest);
  15. if (e.once) {
  16. this.removeListener(type, e);
  17. }
  18. });
  19. }
  20. return true;
  21. }

事件触发需要指定具体的 type 否则直接抛出错误。这个很容易理解,你都没有指定名称,我怎么知道该去执行谁的事件。if (isNullOrUndefined(events)) return false,如果 type 对应的方法是 undefined 或者 null ,直接返回 false 。因为压根没有对应 type 的方法可以执行。而 emit 需要知道是否被成功触发。

接着判断 evnts 是不是一个方法,如果是, events.call(events.context || null, rest) 执行该方法,如果指定了执行主体,用 call 改变 this 的指向指向 events.context 主体,否则指向 null ,全局环境。对于浏览器环境来说就是 window。差点忘了 restrest 是方法执行时的其他参数变量,可以不传,也可以为一个或多个。执行结束后判断 events.once ,如果为 true ,就用 removeListener 移除该监听事件。

如果 evnts 是数组,逻辑一样,只是需要遍历数组去执行所有的监听方法。

成功执行结束后返回 true

</>复制代码

  1. removeListener(type, fn) {
  2. if (isNullOrUndefined(this._events)) return this;
  3. // if type is undefined or null, nothing to do, just return this
  4. if (isNullOrUndefined(type)) return this;
  5. if (typeof fn !== "function") {
  6. throw new Error("fn must be a function");
  7. }
  8. const events = this._events[type];
  9. if (typeof events === "function") {
  10. events === fn && delete this._events[type];
  11. } else {
  12. const findIndex = events.findIndex(e => e === fn);
  13. if (findIndex === -1) return this;
  14. // match the first one, shift faster than splice
  15. if (findIndex === 0) {
  16. events.shift();
  17. } else {
  18. events.splice(findIndex, 1);
  19. }
  20. // just left one listener, change Array to Function
  21. if (events.length === 1) {
  22. this._events[type] = events[0];
  23. }
  24. }
  25. return this;
  26. }

removeListener 接收一个事件名称 type 和一个将要被移除的方法 fnif (isNullOrUndefined(this._events)) return this 这里表示如果 EventEmitter 实例本身的 _eventsnull 或者 undefined 的话,没有任何事件监听,直接返回 this

if (isNullOrUndefined(type)) return this 如果没有提供事件名称,也直接返回 this

</>复制代码

  1. if (typeof fn !== "function") {
  2. throw new Error("fn must be a function");
  3. }

fn 如果不是一个方法,直接抛出错误,很好理解。

接着判断 type 对应的 events 是不是一个方法,是,并且 events === fn 说明 type 对应的方法有且仅有一个,等于我们指定要删除的方法。这个时候 delete this._events[type] 直接删除掉 this._events 对象里 type 即可。

所有的 type 对应的方法都被移除后。想一想 this._events[type] = undefineddelete this._events[type] 会有什么不同?

差异是很大的,this._events[type] = undefined 仅仅是将 this._events 对象里的 type 属性赋值为 undefinedtype 这一属性依然占用内存空间,但其实已经没什么用了。如果这样的 type 一多,有可能造成内存泄漏。delete this._events[type] 则直接删除,不占内存空间。前者也是 Node.js 事件模块和 eventemitter3 早期实现的做法。

如果 events 是数组,这里我没有用 isArray 进行判断,而是直接用一个 else ,原因是 this._events[type] 的输入限制在 on 或者 once 中,而它们已经限制了 this._events[type] 只能是方法组成的数组或者是一个方法,最多加上不小心或者人为赋成 undefinednull 的情况,但这个情况我们也在前面判断过了。

因为 isArray 这个工具方法其实运行效率是不高的,为了追求一些效率,在不影响运行逻辑情况下可以不用 isArray 。而且 typeof events === "function"typeof 判断方法也比 isArray 的效率要高,这也是为什么不先判断是否是数组的原因。用 typeof 去判断一个方法也比 Object.prototype.toSting.call(events) === "[object Function] 效率要高。但数组不能用 typeof 进行判断,因为返回的是 object, 这众所周知。虽然如此,在我面试过的很多人中,仍然有很多人不知道。。。

const findIndex = events.findIndex(e => e === fn) 此处用 ES6 的数组方法 findIndex 直接去查找 fnevents 中的索引。如果 findIndex === -1 说明我们没有找到要删除的 fn ,直接返回 this 就好。如果 findIndex === 0 ,是数组第一个元素,shift 剔除,否则用 splice 剔除。因为 shiftsplice 效率高。

findIndex 的效率其实没有 for 循环去查找的高,所以 eventemitter8 的效率在我没有做 benchmark 之前我就知道肯定会比 eventemitter3 效率要低不少。不那么追求执行效率时当然是用最懒的方式来写最爽。所谓的懒即正义。。。

最后还得判断移除 fnevents 剩余的数量,如果只有一个,基于之前要做的优化,this._events[type] = events[0] 把含有一个元素的数组变成一个方法,降维打击一下。。。

最后的最后 return this 返回自身,链式调用还能用得上。

</>复制代码

  1. removeAllListeners(type) {
  2. if (isNullOrUndefined(this._events)) return this;
  3. // if not provide type, remove all
  4. if (isNullOrUndefined(type)) this._events = Object.create(null);
  5. const events = this._events[type];
  6. if (!isNullOrUndefined(events)) {
  7. // check if type is the last one
  8. if (Object.keys(this._events).length === 1) {
  9. this._events = Object.create(null);
  10. } else {
  11. delete this._events[type];
  12. }
  13. }
  14. return this;
  15. }

removeAllListeners 指的是要删除一个 type 对应的所有方法。参数 type 是可选的,如果未指定 type ,默认把所有的监听事件删除,直接 this._events = Object.create(null) 操作即可,跟初始化 EventEmitter 类一样。

如果 events 既不是 null 且不是 undefined 说明有可删除的 type ,先用 Object.keys(this._events).length === 1 判断是不是最后一个 type 了,如果是,直接初始化 this._events = Object.create(null),否则 delete this._events[type] 直接删除 type 属性,一步到位。

最后返回 this

到目前为止,所有的核心功能已经讲完。

</>复制代码

  1. listeners(type) {
  2. if (isNullOrUndefined(this._events)) return [];
  3. const events = this._events[type];
  4. // use `map` because we need to return a new array
  5. return isNullOrUndefined(events) ? [] : (typeof events === "function" ? [events] : events.map(o => o));
  6. }
  7. listenerCount(type) {
  8. if (isNullOrUndefined(this._events)) return 0;
  9. const events = this._events[type];
  10. return isNullOrUndefined(events) ? 0 : (typeof events === "function" ? 1 : events.length);
  11. }
  12. eventNames() {
  13. if (isNullOrUndefined(this._events)) return [];
  14. return Object.keys(this._events);
  15. }

listeners 返回的是 type 对应的所有方法。结果都是一个数组,如果没有,返回空数组;如果只有一个,把它的方法放到一个数组中返回;如果本来就是一个数组,map 返回。之所以用 map 返回而不是直接 return this._events[type] 是因为 map 返回一个新的数组,是深度复制,修改数组中的值不会影响到原数组。this._events[type] 则返回原数组的一个引用,是浅度复制,稍不小心改变值会影响到原数组。造成这个差异的底层原因是数组是一个引用类型,浅度复制只是指针拷贝。这可以多带带写一篇文章,不展开了。

listenerCount 返回的是 type 对应的方法的个数,代码一眼就明白,不多说。

eventNames 这个返回的是所有 type 组成的数组,没有返回空数组,否则用 Object.keys(this._events) 直接返回。

最后的最后,export default EventEmitterEventEmitter 导出。

结语

我是先看了两个库才知道怎么写的,其实最好的学习方法是知道 EventEmitter 是干什么用的以后自己动手写,写完以后再和那些库进行对比,找出差距,修正再修正。

但也不是说先看再写没有收获,至少比只看不写和看都没看的有收获不是。。。

水平有限,代码错漏或者文章讲不清楚之处在所难免,欢迎大家批评指正。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/93679.html

相关文章

  • JavaScript 发布-订阅模式

    摘要:发布订阅模式订阅者把自己想订阅的事件注册到调度中心,当发布者发布该事件到调度中心,也就是该事件触发时,由调度中心统一调度订阅者注册到调度中心的处理代码。 发布-订阅模式,看似陌生,其实不然。工作中经常会用到,例如 Node.js EventEmitter 中的 on 和 emit 方法;Vue 中的 $on 和 $emit 方法。他们都使用了发布-订阅模式,让开发变得更加高效方便。 一...

    13651657101 评论0 收藏0
  • 从观察者模式到手写EventEmitter源码

    摘要:观察者模式观察者模式广泛的应用于语言中,浏览器事件如鼠标单击,键盘事件都是该模式的例子。可以看到,这就是观察者模式的订阅方法实现。小结通过创建可观察的对象,当发生一个感兴趣的事件时可将该事件通告给所有观察者,从而形成松散的耦合。 观察者模式 观察者模式(observer)广泛的应用于javascript语言中,浏览器事件(如鼠标单击click,键盘事件keyDown)都是该模式的例子。...

    cocopeak 评论0 收藏0
  • [译] 为什么原型继承很重要

    摘要:使用构造函数的原型继承相比使用原型的原型继承更加复杂,我们先看看使用原型的原型继承上面的代码很容易理解。相反的,使用构造函数的原型继承像下面这样当然,构造函数的方式更简单。 五天之前我写了一个关于ES6标准中Class的文章。在里面我介绍了如何用现有的Javascript来模拟类并且介绍了ES6中类的用法,其实它只是一个语法糖。感谢Om Shakar以及Javascript Room中...

    xiao7cn 评论0 收藏0
  • javascript异步编程总结

    摘要:以下总结了异步编程的种方式回调函数回调函数异步编程的最基本的方式。由小组的成员在规范中提出,目的是为异步编程提供统一接口。结尾参考文章异步编程参考文章使用详解 前言 Javascript语言的执行环境是单线程。 单线程: 一次只能完成一个任务。如果有多个任务,就必须排队,前面一个任务完成,再执行后面一个任务。 单线程的好处是执行环境简单,坏处是在一些耗时的任务上会堵塞进程。比如读取一个...

    yearsj 评论0 收藏0
  • 【Node事件模块Events】

    环境:Node v8.2.1; Npm v5.3.0;OS Windows10 1、 Node事件介绍 Node大多数核心 API 都采用惯用的异步事件驱动架构,其中某些类型的对象(触发器)会周期性地触发命名事件来调用函数对象(监听器)。 所有能触发事件的对象都是 EventEmitter 类的实例。 这些对象开放了一个 eventEmitter.on() 函数,允许将一个或多个函数绑定到会被对象...

    junnplus 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<