極簡 Node.js 入門 - 2.2 事件 - ⎝⎛CodingNote.cc ⎞⎠

極簡 Node.js 入門 – 2.2 事件

2020 年 8 月 11 日
筆記
Node.js

極簡 Node.js 入門系列教程：//www.yuque.com/sunluyong/node

本文更佳閱讀體驗：//www.yuque.com/sunluyong/node/events

前端對事件肯定不陌生，為 window 綁定 scroll 事件

window.addEventListener('scroll', ev => {
	console.log(ev);
});

Node.js 大部分非同步操作使用事件驅動，所有可以觸發事件的對象都繼承了 EventEmitter 類

事件監聽

on

Node.js 事件監聽使用和 jQuery API 非常類似emitter.on(eventName, listener)

const ee = new EventEmitter();
ee.on('foo', () => console.log('a'));

EventEmitter 實例會維護一個 listener 數組，每次 listener 默認會被添加到數組尾部
每次添加 listener 不會檢查是否添加過，多次調用 on 傳入相同的 eventName 和 listener，會導致 listener 被添加多次

prependListener

emitter.prependListener(eventName, listener)
通過 prependListener 可以把 listener 添加到 listener 數組頭部

const ee = new EventEmitter();
ee.prependListener('foo', () => console.log('a'));

once

如果希望 listener 被觸發一次後就不再觸發，可以使用 once 來綁定事件

const ee = new EventEmitter();
ee.once('foo', () => console.log('a'));

事件觸發

emitter.emit(eventName[, ...args])
在瀏覽器環境中開發者事件相關的大部分工作是訂閱事件，也就是綁定事件處理函數 listener，在 Node.js 事件編程中經常需要創建事件對象，在合理實際觸發事件。使用 emit 方法可以按照 listener 註冊的順序，同步地調用每個註冊到名為 eventName 的事件的監聽器，並傳入提供的參數

const EventEmitter = require('events');
const myEmitter = new EventEmitter();

// 第一個監聽器。
myEmitter.on('event', function firstListener() {
  console.log('第一個監聽器');
});
// 第二個監聽器。
myEmitter.on('event', function secondListener(arg1, arg2) {
  console.log(`第二個監聽器中的事件有參數 ${arg1}、${arg2}`);
});
// 第三個監聽器
myEmitter.on('event', function thirdListener(...args) {
  const parameters = args.join(', ');
  console.log(`第三個監聽器中的事件有參數 ${parameters}`);
});

console.log(myEmitter.listeners('event'));

myEmitter.emit('event', 1, 2, 3, 4, 5);

// Prints:
// [
//   [Function: firstListener],
//   [Function: secondListener],
//   [Function: thirdListener]
// ]
// 第一個監聽器
// 第二個監聽器中的事件有參數 1、2
// 第三個監聽器中的事件有參數 1, 2, 3, 4, 5

this 指向

eventEmitter.emit() 方法可以傳任意數量的參數到 listener， this 關鍵詞會被指向 listener 所綁定的 EventEmitter 實例

const myEmitter = new MyEmitter();
myEmitter.on('event', function(a, b) {
  console.log(a, b, this, this === myEmitter);
  // 列印:
  //   a b MyEmitter {
  //     domain: null,
  //     _events: { event: [Function] },
  //     _eventsCount: 1,
  //     _maxListeners: undefined } true
});
myEmitter.emit('event', 'a', 'b');

也可以使用 ES6 的箭頭函數作為監聽器。但 this 關鍵詞不會指向 EventEmitter 實例：

const myEmitter = new MyEmitter();
myEmitter.on('event', (a, b) => {
  console.log(a, b, this);
  // 列印: a b {}
});
myEmitter.emit('event', 'a', 'b');

非同步調用

EventEmitter 以註冊的順序同步地調用所有 listener，這樣可以確保事件的正確排序，listener 可以使用 setImmediate() 和 process.nextTick() 方法切換到非同步的操作模式

const myEmitter = new MyEmitter();
myEmitter.on('event', (a, b) => {
  setImmediate(() => {
    console.log('非同步地發生');
  });
});
myEmitter.emit('event', 'a', 'b');

事件卸載

Node.js 提供了幾種卸載事件綁定的方法

off/removeListener

off 方法是 removeListener 方法的別名，用於清理事件綁定 emitter.removeListener(eventName, listener)

const callback = (stream) => {
  console.log('已連接');
};
server.on('connection', callback);
// ...
server.removeListener('connection', callback);

removeListener() 最多只會從監聽器數組中移除一個監聽器。如果監聽器被多次添加到指定 eventName 的監聽器數組中，則必須多次調用 removeListener() 才能移除所有實例

removeAllListeners

emitter.removeAllListeners([eventName])
移除指定的 eventName 事件的 listener，如果沒有指定 eventName，則移除事件對象的所有 listener。可以通過 emitter.eventNames() 獲取事件對象上的 eventName 數組

const EventEmitter = require('events');
const myEE = new EventEmitter();
myEE.on('foo', () => {});
myEE.on('bar', () => {});

myEE.eventNames().forEach(eventName => myEE.removeAllListeners);

Tags: Node.js