في هذا الدرس 5تصفّح المواضيع
بدلاً من إنشاء عداد يدوي وفحص i < array.length وزيادته في كل دورة، توفّر المصفوفات الدالة المدمجة array.forEach(...) لتتولى المرور التلقائي المنظم على عناصر القائمة من البداية إلى النهاية.
يكفي تمرير دالة استدعاء بصيغة forEach(function (item) { ... }) لكي يشغلها المحرك تلقائياً مرةً واحدةً لكل عنصر بترتيب الفهارس التصاعدي.
تمرر دالة forEach في كل دورة ثلاثة وسائط بالترتيب إلى الدالة الداخلية؛ ويمكنك الاكتفاء بالأول فقط أو استقبال الثاني والثالث عند الحاجة:
| ترتيب الوسيط | الاسم المتعارف عليه | القيمة الممررة في كل دورة |
|---|---|---|
| الأول (أساسي) | item | قيمة العنصر الحالي داخل المصفوفة |
| الثاني (اختياري) | index | رقم الفهرس الصفري للعنصر الحالي (0، 1، ...) |
| الثالث (اختياري) | array | مرجع المصفوفة الأصلية التي يجري المرور عليها |
const langs = ['HTML', 'CSS', 'JavaScript'];
let summary = '';
langs.forEach(function (name, idx) {
summary += `#${idx + 1}: ${name} `;
});
document.getElementById('out').textContent = summary.trim();
من أشهر التطبيقات العملية لدالة forEach جمع أسعار عناصر سلة المشتريات وتجهيز ملخص نصي منسق في دورة واحدة مقروءة، ثم تحديث عنصر الصفحة مرةً واحدةً بعد انتهاء المرور لتحقيق أفضل أداء.
const prices = [45, 30, 25];
let total = 0;
prices.forEach(function (price) {
total += price;
});
document.getElementById('out').textContent =
`Items: ${prices.length} | Total: ${total} USD`;
نظراً لأن forEach تستدعي دالة منفصلة لكل عنصر، فإن كتابة تعليمة break بداخلها تطلق خطأً نحوياً SyntaxError، كما أن الخروج من الدالة الداخلية لعنصر واحد لا يوقف المرور على بقية عناصر المصفوفة.
كذلك تُرجع array.forEach(...) دائماً القيمة undefined؛ لذا إذا احتجت إلى التوقف الفوري عند العثور على هدف محدد فاستخدم حلقة for القياسية.
يخلط بعض المبتدئين بين المرور على المصفوفات وفحص خصائص الكائنات؛ والقاعدة الصارمة هي تجنب استخدام صيغة الفهرسة الكائنية مع المصفوفات لأنها تُعامل الفهارس كنصوص ("0" بدلاً من الرقم 0) وقد تلتقط خصائص إضافية غير مرغوبة.
اعتمد دائماً للمصفوفات على forEach() أو حلقة العداد for أو حلقة القيم المباشرة التي سنتعلمها في الدرس القادم.
ملخص الدرس
حصاد الدرسمراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي
ماذا تعلّمت في هذا الدرس؟
أتقنت في هذا الدرس المرور المنظم على المصفوفات عبر forEach() واستقبال الوسائط الثلاثة (item, index, array)، وأدركت عدم قابليتها للتوقف بـ break وإرجاعها الدائم لـ undefined. الخطوة التالية: انتقل الآن إلى درس «حلقتا التكرار for...of وfor...in» لقراءة قيم القوائم ومفاتيح الكائنات باحترافية.
سجّل الدخول لحفظ تقدمك
تابع إنجاز المواضيع والمصطلحات والمهام، وكمّل من آخر خطوة على أي جهاز.
المصطلحات3
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 Array.prototype.forEach() دالة التكرار forEach
- دالة مدمجة في المصفوفات تنفذ دالة استدعاء ممررة مرة واحدة لكل عنصر موجود بترتيب الفهارس التصاعدي.
- للمراجعة
- 02 Callback Function دالة الاستدعاء الراجع
- دالة تُمرر كوسيط إلى دالة أخرى مثل forEach ليتولى المحرك استدعاءها تلقائياً مع كل عنصر.
- للمراجعة
- 03 Zero-Based Index الفهرس الصفري
- الوسيط الثاني في دالة forEach ويبدأ بالرقم 0 للعنصر الأول وينتهي عند الطول ناقص واحد.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات1
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 DOM DOM
- Document Object Model
- شجرة كائنات الصفحة التي يُفضل تحديثها مرة واحدة بعد تجميع النصوص داخل دورة forEach.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
اختر التبويب الثاني في محاكي forEach لملاحظة كيف يحوّل التعبير idx + 1 الفهارس الصفرية إلى ترقيم يبدأ من 1.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.