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 الكامل بالعربي.