Node.js - 事件發射器：初學者指南

你好啊，未來的編程超新星！今天，我們將踏上一段令人興奮的旅程，探索 Node.js 事件發射器的世界。別擔心如果你從未寫過一行代碼——我將成為你的友好導遊，我們將一步步攻克這個主題。在本教程結束時，你將能像專家一樣發射事件！

Node.js - Event Emitter

什麼是事件發射器？

在我們深入代碼之前，讓我們先了解什麼是事件發射器。想像你在一個派對上（當然是編程派對！）。DJ 是事件發射器。他播放音樂（發射事件），當他播放你喜歡的歌曲時，你開始跳舞（對事件做出反應）。在 Node.js 中，事件發射器就像那個 DJ —— 它可以發出信號，程序的其他部分可以聽到並對其做出反應。

開始使用事件發射器

讓我們從一個簡單的例子開始，看看 Node.js 中的事件發射器是如何工作的。

const EventEmitter = require('events');

// 創建一個新的事件發射器
const myEmitter = new EventEmitter();

// 定義一個事件監聽器
myEmitter.on('greet', () => {
console.log('Hello, World!');
});

// 發射事件
myEmitter.emit('greet');

讓我們分解一下：

我們導入 events 模塊，這給我們提供了事件發射器的功能。
我們創建一個新的事件發射器對象，名為 myEmitter。
我們使用 on 方法為名為 'greet' 的事件設置一個監聽器。
當 'greet' 事件發生時，它會將 "Hello, World!" 輸出到控制台。
最後，我們使用 emit 方法觸發 'greet' 事件。

當你運行這段代碼時，你會在控制台看到 "Hello, World!" 輸出。這就像我們的 DJ 剛剛播放了你喜歡的歌曲！

為事件添加參數

事件也可以攜帶數據。讓我們修改我們的例子以包含一個名稱：

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

myEmitter.on('greet', (name) => {
console.log(`Hello, ${name}!`);
});

myEmitter.emit('greet', 'Alice');
myEmitter.emit('greet', 'Bob');

現在，當我們發射 'greet' 事件時，我們傳遞一個名稱作為參數。我們的監聽器函數接收這個名稱並在問候中使用它。運行這段代碼將輸出：

Hello, Alice!
Hello, Bob!

這就像我們的 DJ 現在在接受歌曲點播並且有獻詞！

多個監聽器

事件發射器的一個很酷的功能是你可以為同一事件添加多個監聽器。讓我們看看這是如何操作的：

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

myEmitter.on('party', () => {
console.log('Let\'s dance!');
});

myEmitter.on('party', () => {
console.log('Time for snacks!');
});

myEmitter.on('party', () => {
console.log('Taking selfies!');
});

myEmitter.emit('party');

當你運行這段代碼時，你會看到：

Let's dance!
Time for snacks!
Taking selfies!

每個監聽器都以自己的方式對 'party' 事件做出反應。這就像我們編程派對上的不同人對同一首歌有不同的反應！

once 方法：一次性監聽器

有時候，你希望監聽器只對事件做出一次反應。為此，我們使用 once 方法：

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

myEmitter.once('special', () => {
console.log('This will only happen once!');
});

myEmitter.emit('special');
myEmitter.emit('special');
myEmitter.emit('special');

這段代碼只會輸出 "This will only happen once!" 一次，即使我們發射了三次事件。這就像我們編程派對上的一次性優惠——你打瞌睡，你就丟失！

錯誤事件

錯誤處理在編程中至關重要。事件發射器有一個特殊的 'error' 事件用於此目的：

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

myEmitter.on('error', (err) => {
console.error('Whoops! There was an error:', err.message);
});

myEmitter.emit('error', new Error('Something went wrong!'));

這段代碼設置了一個 'error' 事件的監聽器，然後發射了一個錯誤。輸出將是：

Whoops! There was an error: Something went wrong!

這就像在我們編程派對上有一個安全網——如果出了問題，我們準備好處理它！

移除監聽器

有時候，你可能想停止聽取某些事件。你可以使用 removeListener 方法來做到這點：

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

function partyTime() {
console.log('Party time!');
}

myEmitter.on('celebrate', partyTime);

myEmitter.emit('celebrate');  // 輸出：Party time!

myEmitter.removeListener('celebrate', partyTime);

myEmitter.emit('celebrate');  // 無輸出

在這裡，我們在第一次發射後移除了監聽器，所以第二次發射不會觸發函數。這就像告訴 DJ 你要暫時停止跳舞！

事件發射器方法

這裡是一個常用的事件發射器方法的表格：

方法	描述
`on(eventName, listener)`	將監聽器函數添加到指定的事件
`emit(eventName[, ...args])`	觸發指定的事件
`once(eventName, listener)`	添加一次性監聽器函數
`removeListener(eventName, listener)`	從事件中移除特定的監聽器
`removeAllListeners([eventName])`	移除所有監聽器或特定事件的全部監聽器
`listeners(eventName)`	返回指定事件的監聽器數組
`listenerCount(eventName)`	返回特定事件的監聽器數量

結論

恭喜你！你剛剛踏入了 Node.js 事件發射器的世界。我們已經介紹了基礎，從創建發射器和監聽器到處理錯誤和移除監聽器。事件發射器是 Node.js 中的強大工具，讓你能夠創建有活力、反應靈敏的程序。

記住，熟能生巧。嘗試創建自己的事件發射器，嘗試不同的事件和監聽器，並且最重要的是，樂在其中！也許你會成為下一次編程派對上的明星 DJ，像專家一樣玩轉那些事件！

快樂編程，願你的事件總能找到他們的監聽器！

Credits: Image by storyset