! التأكيد غير الفارغ

آخر تحديث: 2026-10-22

! التأكيد غير الفارغ

يخبر التأكيد غير الفارغ (اللاحقة !) المترجم بأن «هذه القيمة قطعًا ليست null/undefined الآن»، فيطوي T | null | undefined إلى T. وهو لا يجري أي فحص في وقت التشغيل — فإن كانت القيمة فارغة فعلًا فسوف يتكشف الخطأ لاحقًا عند الوصول إلى الأعضاء؛ لذا احتفظ به للحالات التي استبعدت فيها الفراغ حقًا.

ℹ️ معلومة يحوّل المحرر لغة TypeScript إلى JavaScript ثم يشغّلها (بدون فحص أنواع)؛ راجع ناتج كل مثال لنتيجة فحص الأنواع.

📝 الصيغة

const el = document.getElementById("root")!;  // HTMLElement وليس HTMLElement | null

const user = map.get("alice")!;                // User وليس User | undefined
console.log(user.name);

⚙️ المعاملات

القيمة المُعادة：لا أثر له في وقت التشغيل — تزول ! تمامًا بعد الترجمة؛ وفي وقت الترجمة يقتصر عمله على إزالة null/undefined من النوع.

▶ مثال

عدّل الكود أدناه واضغط «جرّب» لرؤية نتيجة التحويل:

الناتج：

100
no record

(مخرجات التشغيل بعد الترجمة. نجاح الفحص النوعي للعبارة aliceScore + 9 سببه أن ! قد ضيّقت النوع؛ أما كتابة scores.get("bob")! + 1 فستنجح في الترجمة لكنها تعطي NaN في وقت التشغيل — فـ ! لا تفحص شيئًا)

💡 نقاط مهمة

🏷️ تضييق الأنواع والتأكيدات ذو صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ أسئلة شائعة

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن