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

splice()

إضافة أو حذف عناصر بمكانها splice()

splice() تُعدّل المصفوفة الأصلية مباشرة — تحذف عناصر و/أو تضيف عناصر جديدة بموضع محدد، وتُرجع العناصر المحذوفة.

بعكس slice، splice() تُغيّر المصفوفة الأصلية فعليًا. تقبل ثلاثة أنواع من المعاملات: موضع البداية، عدد العناصر المحذوفة، والعناصر الجديدة المراد إدراجها (اختياري).

الصياغة

array.splice(startIndex, deleteCount, ...itemsToInsert);

⚡ جرّب بنفسك

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

⚡ محرّر تفاعلي
const arr = ["a", "b", "c", "d"];
const removed = arr.splice(1, 2, "X", "Y", "Z");
console.log(arr);
console.log(removed);
وحدة التحكّم
اضغط «تشغيل» لرؤية النتيجة هنا.

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

المعاملالوظيفة
startIndexالموضع الذي يبدأ منه التعديل
deleteCountعدد العناصر المراد حذفها من ذلك الموضع
itemsToInsertعناصر جديدة تُدرَج مكان المحذوف (اختياري)

💡 نصائح عملية

  • لحذف عنصر واحد فقط: array.splice(index, 1)
  • للإدراج بدون حذف: array.splice(index, 0, newItem)

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

  • الخلط بينها وبين slice() (بدون p) الآمنة التي لا تعدّل الأصل
  • نسيان أنها تُرجع العناصر المحذوفة وليس المصفوفة الجديدة كاملة

خصائص ذات صلة

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