contextual الأنواع السياقية

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

contextual الأنواع السياقية

النوع السياقي: عندما يقع كدالة مجهولة في «موضع نوعه معروف مسبقًا» (تعليق متغير، استدعاء راجع لطريقة مصفوفة، معالج حدث)، يستنتج TS أنواع معاملاتها عكسيًا — دون حاجة لكتابة تعليقات يدويًا. فالمتغير o في map((o) => o.id) له نوع ليس لاستدلال من الدالة نفسها، بل لأنه قادم من نوع عناصر المصفوفة، أي من «السياق».

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

📝 الصيغة

const orders: Order[] = [];

// يأخذ مُعامل الدالة o نوعه السياقي Order من نوع عناصر orders
const summaries = orders.map((o) => `#${o.id}: ${o.total}`);

// تأشيرة المتغير توفر سياقًا أيضًا
type ClickHandler = (event: { x: number; y: number }) => void;
const onClick: ClickHandler = (event) => console.log(event.x, event.y);

⚙️ المعاملات

القيمة المُعادة：تخضع تعبيرات return أيضًا لقيود السياق: فنوع الإرجاع المُعلن يفحص كل return عكسيًا، فيلتقط مبكرًا أخطاء مثل «نسيان return في أحد الفروع».

▶ مثال

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

الناتج：

#101: 250, #102: 90, #103: 480
2
click @ 12,34

(مخرجات التشغيل بعد التحويل؛ كتابة o.pric (اسم خاصية مخطئ) في الاستدعاء الراجع تعطي خطأ ترجمة فوريًا — النوع السياقي لا يسمح به)

💡 نقاط مهمة

🏷️ الدوال والأصناف ذات صلة

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

❓ أسئلة شائعة

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

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

من نحن