الأحداث (Events) في كوكب Kawkab

تعد الأحداث جزءًا أساسيًا في بناء التطبيقات الحديثة، حيث تتيح لك آلية إصدار وتنفيذ الأحداث (Event Emitters) التفاعل مع أجزاء مختلفة من التطبيق بطريقة مرنة وقابلة للتوسيع. في إطار العمل كوكب Kawkab، يمكن للمطورين إنشاء أحداث بسهولة باستخدام أوامر CLI، وهي وسيلة قوية لإضافة وظائف ديناميكية في تطبيقاتهم.

أمر الإنشاء

لإنشاء حدث جديد، يمكنك استخدام الأمر التالي:

npm run kawkab event:make <name> <event> [module]

• <name>: اسم الملف الذي سيتم إنشاؤه.
• <event>: اسم الحدث الذي سيتم إطلاقه.
• [module]: اسم الموديل (وهو اختياري، وسيتم تعيينه إلى “main” بشكل افتراضي إذا لم يتم تحديده).

مثال:

لنفترض أنك تريد إنشاء حدث يقوم بتوليد OTP (رمز تحقق) لمستخدم، يمكنك تنفيذ الأمر التالي:

npm run kawkab event:make generateLoginOTP user

نتيجة الملف المنشأ:

سيتم إنشاء ملف جديد بالاسم generateLoginOTP.ts في المسار الذي يتم تحديده (app/main/events/user/generateLoginOTP.ts). محتويات الملف ستكون كالتالي:

export default function (data: any) {
  console.log("Event triggered:", data);
}

شرح الكود:

• الوظيفة export default function: هذه هي الوظيفة التي يتم تنفيذها عندما يتم إطلاق الحدث. تستقبل هذه الوظيفة بيانات (data) وتطبعها باستخدام console.log.
• data: هو الكائن الذي يتم تمريره عند إطلاق الحدث، ويمكن أن يتضمن أي بيانات ترغب في معالجتها.

كيفية استخدام الحدث:

بعد إنشاء الحدث، يمكنك إطلاقه من أي مكان داخل التطبيق باستخدام الكود التالي:

import { event } from "kawkab";
 
// إطلاق الحدث
event.emit('user');

تمرير البيانات مع الحدث:

يمكنك أيضًا تمرير البيانات مع الحدث باستخدام الكود التالي:

event.emit('user', { otp: '123456', userId: 1 });

خاتمة:

الأحداث هي طريقة قوية لتنظيم العمل في تطبيقاتك، حيث تسمح بتفاعل مرن بين مختلف أجزاء النظام. مع Kawkab، أصبحت عملية إنشاء وإدارة الأحداث سهلة ومرنة، مما يساعدك في بناء تطبيقات قوية وأكثر تفاعلية.