Array.includes() التحقق من وجود عنصر
آخر تحديث: 2026-10-13
Array.includes() التحقق من وجود عنصر
includes يتحقق مما إذا كانت المصفوفة تحتوي القيمة المحددة، مُعيدًا true أو false. أوضح من indexOf ويتعرف على NaN.
| التصنيف | المصفوفات |
|---|
⚙️ المعاملات
| searchValue | |
|---|---|
| fromIndex |
القيمة المُعادة：قيمة منطقية.
يعدّل القيمة الأصلية：لا (يُعيد قيمة جديدة)
▶ مثال
عدّل الكود واضغط تشغيل لرؤية النتيجة في لوحة المخرجات:
المخرجات：
true
false
true
-1
false💡 تلميح
ℹ️ info
🌐 دعم المتصفح
| المتصفح |  Chrome |
 Edge |
 Firefox |
 Safari |
 Opera |
|---|---|---|---|---|---|
| Array.includes() | ✓ v47 | ✓ v14 | ✓ v43 | ✓ v9 | ✓ v34 |
| مدعوم في جميع المتصفحات الحديثة | |||||
🏷️ دوال المصفوفات ذات صلة
💡 حالات ذات صلة
المزيد من الحالات قادم قريباً — تابعونا.
📚 دروس ذات صلة
❓ أسئلة شائعة
Qincludes أم indexOf؟
Aاستخدم includes للتحقق من الوجود؛ وindexOf فقط عندما تحتاج الموضع.
Qهل يعثر includes على الكائنات؟
Aفقط بالمرجع. استخدم some(u => u.id === 3) لمطابقة الكائنات حسب الخاصية.
Qما فائدة fromIndex؟
Aيبدأ البحث من موقع لاحق؛ الأرقام السالبة تُحسب من النهاية — مثلًا فحص آخر 3 عناصر فقط.
