إعداد TypeScript مع Node.js

ترحيب

تهيئة المشروع

npm init -y
npm install --save-dev typescript @types/node ts-node

tsconfig لمشاريع Node

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "strict": true,
    "esModuleInterop": true
  }
}

التشغيل باستخدام ts-node

npx ts-node src/index.ts
npx tsx watch src/index.ts

بناء الإنتاج

npx tsc
node dist/index.js

Source Maps لتصحيح الأخطاء

{ "compilerOptions": { "sourceMap": true } }

متغيرات البيئة

const port = process.env.PORT ?? '3000';

اختصارات المسارات

{ "compilerOptions": { "paths": { "@/*": ["src/*"] } } }

تكامل Nodemon

{ "watch": ["src"], "exec": "ts-node src/index.ts" }

إعداد ESM

{ "compilerOptions": { "module": "NodeNext" } }

تحميل الإعدادات بأمان من ناحية الأنواع

interface AppConfig { port: number; db: string; }
const config: AppConfig = require('./config.json');

تحقق سريع

مراجعة