التكوين باستخدام tsconfig.json

يحدد الملف tsconfig.json الدليل الجذر لمشروع TypeScript وخيارات المترجم المطلوبة لإنشاء المشروع.

عندما تقوم بتشغيل tsc في دليل المشروع، يبحث المترجم عن هذا الملف لتوجيه سلوك الترجمة الخاص به.

بنية ملف tsconfig.json

يبدو ملف التكوين النموذجي كما يلي:

{
  "compilerOptions": {
    "target": "es2022",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "outDir": "./dist"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "**/*.spec.ts"]
}

الخصائص الرئيسية هي:

• compilerOptions: إعدادات المترجم.
• include: يحدد الملفات أو المجلدات المطلوب تجميعها.
• exclude: يحدد الملفات أو المجلدات التي سيتم تجاهلها أثناء التجميع.

خيارات المترجم الرئيسية

فيما يلي بعض أهم الإعدادات التي يجب معرفتها:

1. target: يحدد إصدار إخراج JavaScript بواسطة المترجم (على سبيل المثال، es5، ​​es6/es2015، es2020، esnext).
2. module: يحدد نظام الوحدة المستخدم في التعليمات البرمجية المجمعة (على سبيل المثال، commonjs، esnext، node16).
3. strict: تمكين مجموعة واسعة من السلوكيات الصارمة للتحقق من النوع. يوصى بشدة بضبط هذا على true للحصول على أقصى قدر من الأمان للكتابة. يتيح خيارات مثل:
   • noImplicitAny: ظهور خطأ في التعبيرات والإعلانات ذات النوع الضمني any عندما لا يتم توفير تعليق توضيحي للنوع.
   • strictNullChecks: يمنع تعيين null أو undefined للأنواع التي لا تتضمنها صراحةً في اتحادها.

جربه بنفسك

التمرين 1: التعامل مع عمليات التحقق الصارمة

التمرين 2: الكتابة الصارمة دون أي ضمنية