تخطَّ إلى المحتوى

map()

تحويل كل عنصر بمصفوفة map()

map() تُرجع مصفوفة جديدة بنفس الطول، كل عنصر فيها ناتج تطبيق دالة على العنصر المقابل بالأصل.

map() لا تعدّل المصفوفة الأصلية إطلاقًا — تبني مصفوفة جديدة كليًا. الدالة الممرَّرة تستقبل (العنصر، الفهرس، المصفوفة الكاملة) وتُرجع القيمة الجديدة لكل موضع.

الاستخدام الأشيع: تحويل بيانات خام لشكل جاهز للعرض، مثل تحويل مصفوفة أسعار لمصفوفة نصوص منسّقة.

الصياغة

const result = array.map((item, index, arr) => newValue);

⚡ جرّب بنفسك

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

⚡ محرّر تفاعلي
const prices = [10, 20, 30];
const withTax = prices.map(p => p * 1.15);
console.log(withTax);
console.log(prices);
وحدة التحكّم
اضغط «تشغيل» لرؤية النتيجة هنا.

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

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

💡 نصائح عملية

  • استخدمها فقط عندما تريد فعليًا استخدام المصفوفة الجديدة الناتجة
  • map ترجع مصفوفة بنفس طول الأصل دائمًا — لتقليل العناصر استخدم filter

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

  • استخدام map فقط لتنفيذ فعل جانبي بدون استخدام الناتج — استخدم forEach بدلًا منها
  • نسيان return داخل دالة سهمية بجسم بين قوسين {} — يُرجع undefined لكل عنصر

خصائص ذات صلة

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