當你想徹底擺脫某個事件(或所有事件)上掛載的監聽器時,emitter.removeAllListeners 是最乾脆的做法。
它會移除所有監聽器;如果指定了 event,則只移除該事件的所有監聽器。
emitter.removeAllListeners([event])
// 移除所有監聽器
emitter.removeAllListeners()
// 移除指定 event 的所有監聽器
emitter.removeAllListeners('data')
前者不帶參數,會清空該 emitter 上所有事件的監聽器;後者只針對 'data' 事件生效。
原始碼中對「是否有人監聽 removeListener 事件」做了分支處理:若沒有人監聽,直接清空即可;若有,則會逐一透過 removeListener 移除(以 LIFO 順序),確保能正確觸發相應的 removeListener 事件:
EventEmitter.prototype.removeAllListeners = function(type) {
var key, listeners;
if (!this._events)
return this;
// not listening for removeListener, no need to emit
if (!this._events.removeListener) {
if (arguments.length === 0)
this._events = {};
else if (this._events[type])
delete this._events[type];
return this;
}
// emit removeListener for all listeners on all events
if (arguments.length === 0) {
for (key in this._events) {
if (key === 'removeListener') continue;
this.removeAllListeners(key);
}
this.removeAllListeners('removeListener');
this._events = {};
return this;
}
listeners = this._events[type];
if (util.isFunction(listeners)) {
this.removeListener(type, listeners);
} else {
// LIFO order
while (listeners.length)
this.removeListener(type, listeners[listeners.length - 1]);
}
delete this._events[type];
return this;
};
這個方法在物件銷毀或重置狀態時特別好用,能避免殘留監聽器造成的記憶體洩漏。