دستور events.EventEmitter در Node.js

دستور events.EventEmitter در Node.js
====================================

دستور events.EventEmitter در Node.js

دستور events.EventEmitter یکی از دستورات مهم در برنامه‌نویسی با زبان نود جی‌اس است. این دستور برای ایجاد و مدیریت رویدادها و رخدادها در برنامه‌های نود جی‌اس استفاده می‌شود. با استفاده از این دستور، می‌توانید برنامه‌های خود را به رویدادها و واکنش‌ها به آن‌ها متصل کنید.

در این مقاله، به بررسی دقیق‌تر دستور events.EventEmitter و کاربردهای آن در برنامه‌نویسی با نود جی‌اس می‌پردازیم. همچنین، مثال‌هایی از استفاده از این دستور را نیز مشاهده خواهید کرد.

فهرست مطالب

مقدمه

هنگام برنامه‌نویسی با زبان نود جی‌اس، ممکن است نیاز داشته باشید تا رویدادها و واکنش‌ها را در برنامه خود پیاده‌سازی کنید. برای این کار، می‌توانید از دستور events.EventEmitter استفاده کنید. این دستور به شما امکان می‌دهد رویدادها را ایجاد کنید و به آن‌ها واکنش‌هایی را متصل کنید.

با استفاده از events.EventEmitter می‌توانید برنامه‌های خود را به رویدادهایی که در طول اجرای برنامه رخ می‌دهند، متصل کنید. به عنوان مثال، می‌توانید یک رویداد برای وقوع خطاها در برنامه ایجاد کنید و به آن واکنشی بنویسید که خطا را گزارش کند و یا برنامه را متوقف کند.

برای استفاده از دستور events.EventEmitter در Node.js، ابتدا باید این دستور را در برنامه خود به صورت زیر فراخوانی کنید:

“`javascript
const EventEmitter = require(‘events’);
“`

نحوه استفاده از events.EventEmitter

پس از فراخوانی دستور events.EventEmitter، می‌توانید یک شیء جدید از آن ایجاد کنید. سپس با استفاده از این شیء، می‌توانید رویدادها را ایجاد کنید و به آن‌ها واکنش‌ها را متصل کنید.

برای ایجاد یک رویداد، باید از تابع emit استفاده کنید. این تابع به عنوان پارامتر اول نام رویداد را می‌گیرد و می‌توانید پارامترهای دیگری نیز به آن بدهید. سپس با فراخوانی این تابع، رویداد ایجاد می‌شود و تمام واکنش‌های متصل شده به آن اجرا می‌شوند.

“`javascript
myEmitter.emit(‘event’, arg1, arg2, …);
“`

برای متصل کردن واکنش به یک رویداد، باید از تابع on یا once استفاده کنید. تابع on واکنش متصل شده را هر بار که رویداد رخ می‌دهد اجرا می‌کند، در حالی که تابع once واکنش متصل شده را فقط یک بار اجرا می‌کند.

“`javascript
myEmitter.on(‘event’, (arg1, arg2, …) => {
// واکنش متصل شده به رویداد
});

myEmitter.once(‘event’, (arg1, arg2, …) => {
// واکنش متصل شده به رویداد
});
“`

مثال‌های عملی

در این قسمت، چند مثال از استفاده از دستور events.EventEmitter در برنامه‌نویسی با نود جی‌اس را مشاهده می‌کنید.

مثال ۱ – رویدادهای سفارشی

فرض کنید می‌خواهید یک رویداد سفارشی ایجاد کنید که هر بار که یک کاربر جدید ثبت نام می‌کند، اجرا شود. در این صورت، می‌توانید به شکل زیر عمل کنید:

“`javascript
const EventEmitter = require(‘events’);
const myEmitter = new EventEmitter();

myEmitter.on(‘newUser’, (username) => {
console.log(`کاربر جدیدی با نام ${username} ثبت نام کرد.`);
});

function registerNewUser(username) {
// ثبت نام کاربر جدید
myEmitter.emit(‘newUser’, username);
}

registerNewUser(‘John’);
registerNewUser(‘Jane’);
“`

در این مثال، یک شیء جدید از دستور events.EventEmitter ایجاد می‌کنیم و یک واکنش به رویداد “newUser” متصل می‌کنیم. سپس با فراخوانی تابع registerNewUser و پاس دادن نام کاربر جدید، رویداد “newUser” ایجاد می‌شود و واکنش متصل شده به آن اجرا می‌شود.

مثال ۲ – رویدادهای سیستمی

در مثال دیگری، فرض کنید می‌خواهید یک رویداد سیستمی به نام “shutdown” ایجاد کنید که هر بار که برنامه بسته می‌شود اجرا شود. می‌توانید به شکل زیر عمل کنید:

“`javascript
const EventEmitter = require(‘events’);
const myEmitter = new EventEmitter();

process.on(‘exit’, () => {
myEmitter.emit(‘shutdown’);
});

myEmitter.on(‘shutdown’, () => {
console.log(‘برنامه به درستی بسته شد.’);
});
“`

در این مثال، با استفاده از تابع process.on و واکنش متصل شده به رویداد “exit”، رویداد “shutdown” ایجاد می‌شود و واکنش متصل شده به آن اجرا می‌شود. این کد در زمانی که برنامه بسته می‌شود اجرا می‌شود و پیامی را در کنسول نمایش می‌دهد.

پیشنیازها

برای استفاده از دستور events.EventEmitter در برنامه‌نویسی با نود جی‌اس، باید ابتدا نود جی‌اس را نصب کنید. می‌توانید از سایت رسمی نود جی‌اس (https://nodejs.org) نسخه‌ای که با سیستم عامل خود سازگار است را دانلود و نصب کنید.

همچنین، برای استفاده از دستور events.EventEmitter، باید با مفاهیم برنامه‌نویسی پیشرفته آشنا باشید. اگر با اصول برنامه‌نویسی رویدادگرا (Event-driven programming) آشنا نیستید، ممکن است مفهوم استفاده از رویدادها و واکنش‌ها در برنامه‌نویسی با نود ج