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

includes()

فحص وجود عنصر includes()

includes() تُرجع true أو false — هل توجد قيمة معيّنة داخل المصفوفة (تعمل أيضًا مع النصوص).

طريقة بسيطة وواضحة لفحص الوجود، أوضح من indexOf() !== -1 القديمة. تقارن بالمساواة الصارمة (===) لكل عنصر.

الصياغة

const exists = array.includes(value);

⚡ جرّب بنفسك

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

⚡ محرّر تفاعلي
const roles = ["admin", "writer", "student"];
console.log(roles.includes("writer"));
console.log(roles.includes("owner"));
وحدة التحكّم
اضغط «تشغيل» لرؤية النتيجة هنا.

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

المعاملالوظيفة
valueالقيمة المراد البحث عنها
fromIndexالفهرس الذي يبدأ منه البحث (اختياري)

💡 نصائح عملية

  • أوضح دائمًا من array.indexOf(value) !== -1 القديمة
  • تعمل أيضًا مباشرة على النصوص: "hello".includes("ell")

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

  • استخدامها لمقارنة كائنات — تقارن بالمرجع لا بالمحتوى، فـ [{}].includes({}) دائمًا false

خصائص ذات صلة

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