forEach()

تنفيذ فعل على كل عنصر forEach()

forEach() تُنفّذ دالة على كل عنصر بالمصفوفة دون إرجاع أي مصفوفة جديدة — لتنفيذ أفعال جانبية فقط.

بعكس map، forEach() تُرجع دائمًا undefined — لا تُستخدم لبناء بيانات جديدة بل لتنفيذ فعل (طباعة، تحديث DOM، حفظ بقائمة خارجية). لا يمكن إيقافها بـ break منتصف الطريق (استخدم for...of عادي إن احتجت ذلك).

الصياغة

array.forEach((item, index, arr) => { /* فعل */ });

⚡ جرّب بنفسك

عدّل الكود واضغط «تحديث» لترى النتيجة فورًا — التجربة أفضل معلّم.

⚡ محرّر تفاعلي

const fruits = ["تفاح", "موز", "عنب"];
fruits.forEach((fruit, i) => {
  console.log(i + 1, fruit);
});

وحدة التحكّم

اضغط «تشغيل» لرؤية النتيجة هنا.

أهم المعاملات

المعامل	الوظيفة
item	العنصر الحالي
index	فهرس العنصر (اختياري)

💡 نصائح عملية

استخدمها فقط عند عدم الحاجة لناتج جديد — إن أردت تحويل بيانات استخدم map
لا تدعم break/continue — استخدم for...of عاديًا إن احتجت الخروج المبكر

⚠️ أخطاء شائعة

توقّع إرجاع مصفوفة جديدة من forEach — تُرجع دائمًا undefined
محاولة استخدام await داخل forEach لانتظار كل عنصر بالترتيب — forEach لا تنتظر Promises

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار JAVASCRIPT الكامل بالعربي.