又匆匆忙忙了两周,耽搁了不少进度,这次就先看看events这一块。
大多数Node.js的核心API都是围绕这一个通用的异步事件驱动架构的。emitters发出具名事件,然后再由函数对象listeners监听并作出响应。
发出事件的所有的对象都是EventEmitter
类的实例,这些对象暴露了一个eventEmitter.on()
的函数,允许1个或多个函数对象附加到这个具名事件上。
当EventEmitter
对象发送一个事件,所有和这个事件相关的都会被同步(synchronously
)调用.
eventEmitter.on()
用来注册事件监听,触发事件之后的回调。如下面的官方例子
1 | const EventEmitter = require('events'); |
传参
eventEmitter.emit()
允许随意设置参数带给listener
,这个时候this
会指向绑定事件的对象上——箭头函数会例外。
1 | const myEmitter = new MyEmitter(); |
异步VS同步
EventListener
会按照注册顺序调用所有的listener
,这能够确保事件的执行顺序。
可以通过process.nextTick()
和setImmediate()
这两个方法转化为异步执行。
仅执行一次的事件
通过eventEmitter.once()
来注册事件即可,当触发一次之后就会被注销。
error
事件
若在EventEmitter
实例中出错了,一般会发送一个error
的事件,从而作出特殊的处理。
官方建议最佳实践:listener
应该总是设定error
事件处理,如下所示
1 | const myEmitter = new MyEmitter(); |
EventEmitter类
由events
模块定义和暴露方法。
1 | const EventEmitter = require('events'); |
newListener
和removeListener
newListener
监听注册事件的监听器,听起来有点绕。可以这么理解,我们的房子是各个部件原料组成的,而这个是生产盖房子原料的之前的监听过程。
一个事件我们可以简单的看成有个事件名eventName
,还有监听处理listener
函数,当我们新注册一个事件的时候我们只要指定这两个玩意儿就能够自定义事件了。
而我们在注册之前想要搞点事情。那就可以在newListener
的监听里做处理。
举个栗子:
1 | const EventEmitter = require('events'); |
这里注意要用once。不然得搞坏了。
removeListener
在事件移除的时候触发。
其余api简单笔记
emitter.addListener
是emitter.on(eventName, listener)
的另外一种写法。
emitter.eventNames()
可以查看emmitter
上绑定的事件列表
emitter.prependListener()
可以改变执行顺序,可以作为生命周期的一个阶段来理解。
emitter.setMaxListeners
,默认情况下给一个emitter
添加超过10个事件的时候就会报警,可以通过修改这个设置来避开这个报警。默认设置是为了帮助寻找内存泄漏问题。
其实就开头比较绕,下面部分都很好理解,有一个弃用的api就直接跳过不看了。官方文档解释的非常清晰,英文小菜鸡直接看也能明白~