مشروع: تعريف الـ Struct للمهمة

جزء من قسم مقدمة إلى TypeScript في رحلة JavaScript على Coddy. الدرس 45 من 73.

مرحبًا بك في أول مشروع لك باستخدام TypeScript! خلال الدروس القليلة القادمة، ستبني تطبيقًا متكاملًا لقائمة المهام يوضّح كيف يساعد TypeScript في إنشاء تعليمات برمجية منظّمة جيدًا وآمنة من حيث الأنواع. سيجمع هذا المشروع العديد من المفاهيم التي تعلمتها حتى الآن: interfaces، والأنواع الحرفية، والمصفوفات، والدوال.

أساس أي نظام لإدارة المهام هو تحديد شكل المهمة. في هذا الدرس، ستنشئ بنية البيانات التي تمثل مهمة واحدة في تطبيقك. يجب أن تلتقط هذه البنية المعلومات الأساسية: معرّفًا فريدًا، وما تدور حوله المهمة، وحالتها الحالية.

ستستخدم واجهة Task الخاصة بك الأنواع الحرفية لخاصية status، ما يعني أن status يمكن أن تكون إحدى قيم السلاسل النصية المحددة القليلة فقط، مثل 'todo' أو 'in-progress' أو 'done'. يمنع هذا الأسلوب الأخطاء المطبعية ويضمن الاتساق في جميع أنحاء تطبيقك - إذ سيتعرّف TypeScript على أي محاولة لاستخدام قيمة status غير صالحة.

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

التحدي

سهل

أنشئ interface باسم Task مع الخصائص التالية:

id من النوع number
title من النوع string
status يمكن أن تكون إحدى القيم الحرفية التالية فقط: 'todo' أو 'in-progress' أو 'done'

باستخدام interface ‏Task، أنشئ variables التالية:

أنشئ متغيرًا باسم firstTask من النوع Task، مع id يساوي 1، وtitle يساوي "Learn TypeScript interfaces"، وstatus يساوي 'todo'
أنشئ متغيرًا باسم secondTask من النوع Task، مع id يساوي 2، وtitle يساوي "Build task management app"، وstatus يساوي 'in-progress'
أنشئ متغيرًا باسم thirdTask من النوع Task، مع id يساوي 3، وtitle يساوي "Write unit tests"، وstatus يساوي 'done'

أنشئ دالة باسم getTaskInfo تقبل وسيطًا من النوع Task وتُرجع قيمة من النوع string بالتنسيق "Task [id]: [title] - [status]".

اطبع المخرجات التالية في أسطر منفصلة:

استدعِ getTaskInfo باستخدام firstTask واطبع النتيجة
استدعِ getTaskInfo باستخدام secondTask واطبع النتيجة
استدعِ getTaskInfo باستخدام thirdTask واطبع النتيجة
اطبع حالة firstTask
اطبع عنوان secondTask

جرّب بنفسك

// TODO: اكتب الكود الخاص بك هنا

// أنشئ واجهة Task


// أنشئ متغيرات task


// أنشئ الدالة getTaskInfo


// اطبع المخرجات المطلوبة

اختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس مقدمة إلى TypeScript

1البداية مع TS

ما هي TypeScript؟لماذا نستخدم TypeScript؟أول كود TypeScript لك عملية الـ Compilation والأخطاء ملخص: مقدمة في TS

4التعامل مع الدوال

تحديد أنواع المعاملات وقيم الإرجاع تحديد أنواع Arrow Functions نوع الإرجاع 'void'المعاملات الاختيارية باستخدام '?'القيم الافتراضية للمعاملات تحديد أنواع Rest Parameters تعريف أنواع الدوال ملخص: بناء دوال محددة الأنواع

7مشروع: قائمة مهام بسيطة

مشروع: تعريف الـ Struct للمهمةدالة لإضافة مهمة

دالة لتغيير حالة المهمة

دالة: عرض المهام حسب الحالة

دالة: طباعة ملخص المهام

تجميع كل الأجزاء معاً

10مشروع: إدارة المخزون

مشروع: عنصر مخزون عام دالة: إضافة عناصر إلى المخزون

دالة للبحث عن عنصر بواسطة ID

إنشاء نوع مخزون محدد

دالة للحصول على تفاصيل العنصر

2الأنواع الأساسية

الأنواع الأساسية: str, num, boolean النوع 'any': مخرج الهروب النوع 'unknown'التعامل مع 'null' و 'undef'استنتاج الأنواع في التطبيق العملي توضيحات الأنواع الصريحة مراجعة: تدريب على الأنواع الأساسية

5الأنواع: الأسماء المستعارة، الاتحادات والتقاطعات

الأسماء المستعارة للأنواع الأساسية (Primitives)أنواع الاتحاد ('|')التعامل مع أنواع الاتحاد الأنواع الحرفية (Literal Types)أنواع التقاطع ('&')دمج الأسماء المستعارة للأنواع ملخص: تركيبات الأنواع المتقدمة

8Enums

ما هو الـ Numeric Enum؟استخدام الـ Numeric Enums ما هو الـ String Enum؟استخدام الـ String Enums الـ Heterogeneous Enums ملخص: استخدام الـ Enums

11مواضيع متقدمة

تأكيدات النوع حراس النوع: in و instanceof النوع 'never'الأنواع القابلة للقيمة Null ('strictNull')تواقيع الفهرسة للكائنات ملخص: ضبط الأنواع بدقة

3هياكل البيانات: المصفوفات و Tuple

المصفوفات محددة النوع (Typed Arrays)معدل 'readonly' للمصفوفات ما هو الـ Tuple؟تعريف والوصول إلى الـ Tuples تفكيك الـ Tuples (Destructuring)الـ Tuples للقراءة فقط (Readonly)المصفوفات محددة النوع متعددة الأبعاد استخدام Spread Operator مع المصفوفات ملخص: المصفوفات و Tuples

6تحديد أنواع الكائنات والواجهات

توصيف أنواع الكائنات المضمنة (Inline)الأسماء المستعارة للأنواع (Type Aliases) للكائنات مقدمة عن الواجهات (Interfaces)الواجهات (Interfaces) مقابل الأسماء المستعارة للأنواع (Type Aliases)الخصائص الاختيارية وخصائص القراءة فقط (Readonly)توسيع الواجهات والأنواع إضافة الدوال (Methods) إلى الواجهات ملخص: تحديد هياكل الكائنات

9Generics: نظرة أولى

المشكلة التي تحلها الـ Generics إنشاء دالة Generic Identity استخدام دالة Generic مصفوفات الـ Generic واجهات الـ Generic ملخص: تدريب على الدوال العامة

تدرّب بنفسك: Playground لـ TypeScript