flat()
تسطيح مصفوفة متداخلة flat()
flat() تُرجع مصفوفة جديدة بعد دمج العناصر الفرعية (المصفوفات المتداخلة) بمستوى واحد افتراضيًا، بعمق تتحكم به.
شائعة جدًا بعد عمليات تجميع بيانات تنتج مصفوفات داخل مصفوفات. المعامل depth يحدد عدد المستويات التي تُسطَّح؛ افتراضيًا 1 فقط. لتسطيح كل المستويات مهما كان عمقها، مرّر Infinity.
الصياغة
const flatArr = array.flat(depth); // depth افتراضي 1
⚡ جرّب بنفسك
عدّل الكود واضغط «تحديث» لترى النتيجة فورًا — التجربة أفضل معلّم.
⚡ محرّر تفاعلي
const nested = [1, [2, 3], [4, [5, 6]]]; console.log(nested.flat()); // مستوى واحد فقط console.log(nested.flat(2)); // مستويان console.log(nested.flat(Infinity)); // كل المستويات
وحدة التحكّم
اضغط «تشغيل» لرؤية النتيجة هنا.
أهم المعاملات
| المعامل | الوظيفة |
|---|---|
| depth | عدد مستويات التداخل المراد تسطيحها — افتراضي 1 |
💡 نصائح عملية
- مرّر Infinity كعمق إذا كنت لا تعرف مستوى التداخل مسبقًا
- flat() تحذف أيضًا الفراغات (empty slots) بمصفوفات متفرقة (sparse arrays) كأثر جانبي
⚠️ أخطاء شائعة
- نسيان أن العمق الافتراضي 1 فقط — مصفوفة بثلاث مستويات تحتاج flat(2) على الأقل لتسطيح كامل
خصائص ذات صلة
🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار JAVASCRIPT الكامل بالعربي.