التعدادات

مرحبًا بكم في الدرس التالي! ستتعلمون في هذا الدرس عن التعدادات في TypeScript. تتيح لكم التعدادات تعريف مجموعة من الثوابت المسماة، مما يجعل شيفرتكم أوضح وأسهل في الإدارة. لنبدأ الاستكشاف!

ما التعدادات؟

التعداد (اختصارًا لكلمة enumeration) هو نوع بيانات يتيح لكم تعريف مجموعة من الثوابت المسماة. تُستخدم التعدادات لتجميع القيم المرتبطة معًا، مما يجعل شيفرتكم أكثر تنظيمًا وأقل عرضة للأخطاء.

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

المهمة: أنشئوا تعدادًا لأشهر السنة واطبعوا بعض القيم.

enum Days {
  Monday,
  Tuesday,
  Wednesday,
  Thursday,
  Friday,
  Saturday,
  Sunday,
}

console.log(Days.Monday); // Output: 0
console.log(Days.Friday); // Output: 4

التعدادات الرقمية

تكون التعدادات في TypeScript رقمية افتراضيًا، وتبدأ من 0. ويمكنكم إسناد قيم مخصصة إلى أعضاء التعداد عند الحاجة:

المهمة: عرّفوا تعدادًا لأدوار المستخدمين، مثل Admin وEditor وViewer، مع قيم رقمية مخصصة.

enum Status {
  Active = 1,
  Inactive = 2,
  Pending = 3,
}

console.log(Status.Active); // Output: 1
console.log(Status.Pending); // Output: 3

التعيين العكسي

تدعم تعدادات TypeScript التعيين العكسي، مما يتيح لكم الحصول على اسم عضو التعداد من قيمته:

المهمة: جرّبوا التعيين العكسي باستخدام تعداد من إنشائكم.

enum Colors {
  Red = 1,
  Green,
  Blue,
}

console.log(Colors[1]); // Output: "Red"
console.log(Colors[2]); // Output: "Green"

التعدادات النصية

تدعم TypeScript أيضًا التعدادات النصية، حيث يُسند إلى كل عضو في التعداد قيمة نصية:

المهمة: أنشئوا تعدادًا نصيًا للألوان الأساسية، مثل Red وGreen وBlue.

enum Directions {
  Up = "UP",
  Down = "DOWN",
  Left = "LEFT",
  Right = "RIGHT",
}

console.log(Directions.Up); // Output: "UP"
console.log(Directions.Left); // Output: "LEFT"

التعدادات المتغايرة

يمكن أن يحتوي التعداد على قيم رقمية ونصية معًا، لكن لا يُنصح بذلك عمومًا للحفاظ على الاتساق:

المهمة: عرّفوا تعدادًا مختلطًا ولاحظوا سلوكه في المحرر.

enum Mixed {
  Yes = 1,
  No = "NO",
}

console.log(Mixed.Yes); // Output: 1
console.log(Mixed.No); // Output: "NO"

استخدام التعدادات في الدوال

تُعد التعدادات مفيدة جدًا للتحكم في سير شيفرتكم. مثال:

المهمة: اكتبوا دالة تأخذ تعدادًا كمعلمة وتعيد رسالة.

enum Status {
  Active,
  Inactive,
  Pending,
}

function checkStatus(status: Status): string {
  switch (status) {
    case Status.Active:
      return "The status is active.";
    case Status.Inactive:
      return "The status is inactive.";
    case Status.Pending:
      return "The status is pending.";
    default:
      return "Unknown status.";
  }
}

console.log(checkStatus(Status.Active)); // Output: "The status is active."

الأخطاء الشائعة

إليكم بعض الأخطاء الشائعة عند استخدام التعدادات:

• استخدام التعدادات الرقمية عندما تجعل التعدادات النصية الشيفرة أوضح.
• خلط القيم الرقمية والنصية في التعداد نفسه.
• عدم استخدام التعدادات للقيم التي يمكن أن تستفيد من الثوابت المسماة.

نصيحة: اختاروا نوع التعداد المناسب، رقميًا كان أم نصيًا، استنادًا إلى حالة الاستخدام.

أحسنتم!

تهانينا! لقد تعلمتم كيفية استخدام التعدادات في TypeScript لتعريف الثوابت المسماة. تُعد التعدادات طريقة قوية لجعل شيفرتكم أوضح وأقل عرضة للأخطاء. في الدرس التالي، سنستكشف الأنواع الحرفية، وهي ميزة متقدمة أخرى في TypeScript. واصلوا البرمجة!