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

Array.isArray()

التحقق من أن القيمة مصفوفة فعلًا Array.isArray()

Array.isArray() تُرجع true فقط إذا كانت القيمة الممرَّرة مصفوفة حقيقية — الطريقة الموثوقة الوحيدة لهذا الفحص.

typeof لا تفرّق بين المصفوفة والكائن العادي أبدًا — typeof [] يُرجع "object" تمامًا مثل typeof {}. Array.isArray() صُممت خصيصًا لسد هذه الثغرة وتعمل بشكل موثوق حتى عبر إطارات (iframes) مختلفة.

الصياغة

Array.isArray(value); // true أو false

⚡ جرّب بنفسك

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

⚡ محرّر تفاعلي
console.log(Array.isArray([1, 2, 3])); // true
console.log(Array.isArray("مصفوفة؟")); // false
console.log(typeof []); // "object" — لا يفرّق إطلاقًا
وحدة التحكّم
اضغط «تشغيل» لرؤية النتيجة هنا.

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

المعاملالوظيفة
valueأي قيمة تريد التحقق من كونها مصفوفة

💡 نصائح عملية

  • استخدمها دائمًا قبل استدعاء دوال مصفوفات (map، filter) على قيمة غير مؤكّد نوعها، مثل استجابة API خارجية

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

  • استخدام typeof value === "object" لفحص المصفوفات — تُرجع true أيضًا للكائنات العادية وnull بأخطاء قديمة معروفة

خصائص ذات صلة

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