Menu
CoddyTech
flag Ar iconالعربيةdown icon

نوع الإرجاع 'void'

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

عندما تقوم دالة بتنفيذ إجراء ما ولكنها لا تعيد أي شيء ذي معنى، فإنك تستخدم نوع الإرجاع void للإشارة صراحةً إلى هذا القصد.

يمثل النوع void غياب قيمة الإرجاع. عادةً ما تستخدم الدوال التي تسجل الرسائل، أو تُحدّث المتغيرات، أو تؤدي تأثيرات جانبية النوع void كنوع إرجاع لها:

function logMessage(message: string): void {
  console.log(message);
}

function updateCounter(): void {
  counter++;
}

بينما يمكن لـ TypeScript غالباً استنتاج أن الدالة تعيد void، فإن إضافة تعليق : void بشكل صريح تجعل كودك أكثر قابلية للقراءة وتوضح نيتك للمطورين الآخرين بشكل واضح.

challenge icon

التحدي

سهل

قم بإنشاء دالة باسم displayWelcome تأخذ معاملًا userName من نوع string ولديها نوع إرجاع صريح void. يجب أن تقوم الدالة بطباعة رسالة ترحيب إلى وحدة التحكم (console) بالتنسيق التالي: "Welcome to our application, [userName]!"

قم بإنشاء دالة أخرى باسم logError تأخذ معاملًا errorMessage من نوع string ولديها نوع إرجاع صريح void. يجب أن تقوم الدالة بطباعة رسالة خطأ إلى وحدة التحكم بالتنسيق التالي: "ERROR: [errorMessage]"

قم بإنشاء دالة ثالثة باسم processData لا تأخذ أي معاملات ولديها نوع إرجاع صريح void. يجب أن تقوم الدالة بطباعة الرسالة "Processing data..." إلى وحدة التحكم، ثم طباعة "Data processing complete." في سطر جديد.

اختبر دوالك عن طريق استدعائها بالترتيب التالي:

  • استدعِ displayWelcome مع "Alice"
  • استدعِ processData بدون أي وسائط (arguments)
  • استدعِ logError مع "Invalid input detected"
  • استدعِ displayWelcome مع "Bob"

يجب أن ينتج عن كل استدعاء دالة مخرجات في أسطر منفصلة بالترتيب المحدد أعلاه.

جرّب بنفسك

// TODO: اكتب كودك هنا
// أنشئ دالة displayWelcome التي تأخذ userName (string) ولا تعيد أي قيمة (void)
// أنشئ دالة logError التي تأخذ errorMessage (string) ولا تعيد أي قيمة (void)  
// أنشئ دالة processData التي لا تأخذ أي بارامترات ولا تعيد أي قيمة (void)

// TODO: استدعِ الدوال بالترتيب المحدد:
// 1. displayWelcome مع "Alice"
// 2. processData بدون أي وسائط
// 3. logError مع "Invalid input detected"
// 4. displayWelcome مع "Bob"
quiz iconاختبر نفسك

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

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

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