انتقل إلى محتوى الدرس
الدرس 38
تاريخ النشر: تاريخ التحديث:
دورة جافا سكريبت

التكرار بالدالة forEach في JavaScriptJavaScript forEach Loop طريقة تكرار عناصر المصفوفة forEach، وتجميع القوائم النصية forEach، وتجنب for in للمصفوفات

تعلم التكرار على المصفوفات بالدالة forEach() في JavaScript: وسائط العنصر والفهرس والمصفوفة، تجميع القوائم للواجهة، وقيود التوقف المبكر.
أقسام الدرس
5
الأمثلة
2
اللغة
العربية
المشاهدات
5,598
محتوى الدرس
في هذا الدرس 5تصفّح المواضيع

بدلاً من إنشاء عداد يدوي وفحص i < array.length وزيادته في كل دورة، توفّر المصفوفات الدالة المدمجة array.forEach(...) لتتولى المرور التلقائي المنظم على عناصر القائمة من البداية إلى النهاية.

يكفي تمرير دالة استدعاء بصيغة forEach(function (item) { ... }) لكي يشغلها المحرك تلقائياً مرةً واحدةً لكل عنصر بترتيب الفهارس التصاعدي.

مخطط يوضح كيف تمرر دالة forEach قيمة العنصر ورقم فهرسه والمصفوفة إلى دالة الاستدعاء

تمرر دالة forEach في كل دورة ثلاثة وسائط بالترتيب إلى الدالة الداخلية؛ ويمكنك الاكتفاء بالأول فقط أو استقبال الثاني والثالث عند الحاجة:

ترتيب الوسيطالاسم المتعارف عليهالقيمة الممررة في كل دورة
الأول (أساسي)itemقيمة العنصر الحالي داخل المصفوفة
الثاني (اختياري)indexرقم الفهرس الصفري للعنصر الحالي (0، 1، ...)
الثالث (اختياري)arrayمرجع المصفوفة الأصلية التي يجري المرور عليها
JavaScript
const langs = ['HTML', 'CSS', 'JavaScript'];
let summary = '';
langs.forEach(function (name, idx) {
  summary += `#${idx + 1}: ${name}  `;
});
document.getElementById('out').textContent = summary.trim();

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

JavaScript
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

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 3 مفهومةأول بطاقة، أول خطوة
01 Array.prototype.forEach() دالة التكرار forEach
دالة مدمجة في المصفوفات تنفذ دالة استدعاء ممررة مرة واحدة لكل عنصر موجود بترتيب الفهارس التصاعدي.
للمراجعة
02 Callback Function دالة الاستدعاء الراجع
دالة تُمرر كوسيط إلى دالة أخرى مثل forEach ليتولى المحرك استدعاءها تلقائياً مع كل عنصر.
للمراجعة
03 Zero-Based Index الفهرس الصفري
الوسيط الثاني في دالة forEach ويبدأ بالرقم 0 للعنصر الأول وينتهي عند الطول ناقص واحد.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

حروف قليلة. معنى كامل.

الاختصارات1

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 1 مفهومةأول بطاقة، أول خطوة
01 DOM DOM
Document Object Model
شجرة كائنات الصفحة التي يُفضل تحديثها مرة واحدة بعد تجميع النصوص داخل دورة forEach.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

من الفهم للتطبيق

مهامك قبل الاختبار

خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.

0/1مهام منجزة
  1. اختر التبويب الثاني في محاكي forEach لملاحظة كيف يحوّل التعبير idx + 1 الفهارس الصفرية إلى ترقيم يبدأ من 1.

تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.

مساحة التحدي

اختبر فهمك.
ووصلها للإتقان.

كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.

10أسئلة 2أنواع تحديات 100%هدف الإتقان
تصحيح تلقائي. فرص بلا حدود.

أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.

الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.

لمحة عن التحدي10 أسئلة تنتظرك
01

ما الترتيب الصحيح للوسائط الثلاثة التي تمررها دالة forEach إلى دالة الاستدعاء في كل دورة؟

02

ما القيمة التي ترجعها دالة array.forEach(...) نفسها دائماً بعد انتهاء المرور على العناصر؟

03

يمكن استخدام تعليمة break مباشرةً داخل دالة forEach لإيقاف المرور على بقية عناصر المصفوفة.

04

بعد تنفيذ الكود const nums = [10, 20, 30]; let s = 0; nums.forEach(function (n) { s += n; }); كم تبلغ قيمة s؟

05

تعريف الوسيطين الثاني والثالث (index وarray) في دالة الاستدعاء داخل forEach أمر اختياري.

06

في المصفوفة ["A", "B"] ما قيمة الفهرس (index) الممررة لدالة forEach عند زيارة العنصر الأول "A"؟

07

تتخطى دالة forEach() تلقائياً الخانات الفارغة غير المهيأة في المصفوفات المتفرقة.

08

أي أداة تختارها بدلاً من forEach عندما تحتاج للتوقف الفوري بمجرد العثور على أول عنصر مطابق؟

09

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

10

لماذا يُعد تجميع النص في متغير محلي أثناء forEach ثم تحديث textContent مرة واحدة في النهاية أفضل أداءً؟