node.js事件:
Events
events.EventEmitter
emitter.addListener(event, listener)
emitter.on(event, listener)
emitter.once(event, listener)
emitter.removeListener(event, listener)
emitter.removeAllListeners([event])
emitter.setMaxListeners(n)
emitter.listeners(event)
emitter.emit(event, [arg1], [arg2], [...])
Event: 'newListener'
Events
许多对象在Node中可以派发事件:
一个net.Server每次一个链接链接到它时派发一个事件,当一个文件被打开时fs.readStream派发一个事件。
所有派发事件的对象都是events.EventEmitter 的实体。
可以通过 require('events') 访问此模块。
一般事件名称是用一个大小写混合(camel-cased )的字符串表示,然而,没有严格的限制,因为任何字符串将被接受。
函数可以归宿某个对象,当事件派发时可以被执行。这些函数叫做监听器。
events.EventEmitter
可以通过require('events').EventEmitter访问EeventEmitter类。
当一个EventEmitter表达错误时,一般会派发一个'error'事件, Error事件在node中作为一个特例。如果没有对此做监听,默认行为就是打印错误日志并退出当前程序。
当一个新的监听添加时,所有EventEmitter派发一个'newListener'。
添加一个监听器到事件监听集合末端,为指定事件。
emitter.once(event, listener)
为事件添加一个一次性的监听器,这个监听器将只在事件下次激活时派发调用,在此之后这个监听将会被删除。
emitter.removeListener(event, listener)
从事件监听器集合中删除指定的监听器。注意:在监听器之后改变监听器集合的索引。
删除所有的事件监听。
emitter.setMaxListeners(n)
默认情况下当一个事件的监听超过10个时,EventEmitter 将打印警告信息。
这对于内存泄漏的查找很有帮助。www.edata8.com
当然也不是所有的Emitters都应该限制在10个。
这些函数允许增长,设置0表示无限制。
emitter.listeners(event)
返回特定事件的事件监听器集合。这个集合可以人工干预,如删除一个事件监听器。
例子:
emitter.emit(event, [arg1], [arg2], [...])
用提供的参数按顺序执行每个事件监听器。
当添加新的监听时,这个事件每次都会被派发。