Het configureren van een TypeScript-project voor een backend Node.js-service met Express begint met het maken van een goed `tsconfig.json`-bestand en een efficiënte projectstructuur. Hier volgt een uitgebreide uitleg en voorbeelden. ### 1. `tsconfig.json` configuratie voor Node.js + Express Een typisch `tsconfig.json`-bestand voor een Node.js backend met TypeScript bevat de volgende onderdelen: ```json { "compilerOptions": { "target": "ES2022", // JavaScript versie voor output "module": "CommonJS", // Module systeem voor Node.js "outDir": "./dist", // Uitvoer map voor getranspileerde code "rootDir": "./src", // Hoofdmap voor bronbestanden "strict": true, // Strikte type-controles "esModuleInterop": true, // Interoperabiliteit met ES modules "skipLibCheck": true, // Libraries overslaan bij type-checking "forceConsistentCasingInFileNames": true, "noImplicitAny": true, // Geen impliciete 'any'-typen "moduleResolution": "node", // Module resolution voor Node.js "resolveJsonModule": true, // JSON-bestanden importeren "sourceMap": true, // Source maps voor debugging "declaration": false, // Geen declaratiebestanden nodig voor app "removeComments": true // Commentaar uit output verwijderen }, "include": ["src/**/*"], // Bestanden om te compileren "exclude": ["node_modules", "dist"] // Mappen die uitgesloten worden } ``` ### 2. Efficiënte projectstructuur Voor schaalbaarheid en onderhoudbaarheid wordt aanbevolen om je project te organiseren volgens een modulaire en logische structuur. Een voorbeeld: ``` /project-root │ ├── /src │ ├── /controllers # Logica voor API endpoints │ ├── /routes # Route-definities │ ├── /services # Business logica en services │ ├── /models # Data modellen (interfaces, types) │ ├── /middlewares # Express middleware │ ├── /utils # Hulpfuncties │ ├── app.ts # Hoofdbestand voor Express app │ └── server.ts # Startpunt van de server │ ├── /dist # Gecompileerde JavaScript-bestanden ├── package.json └── tsconfig.json ``` ### 3. Aanvullende tips voor schaalbaarheid en onderhoud - **Gebruik modules en namespaces**: Deel je code op in kleine, herbruikbare modules. - **Type definities**: Gebruik interfaces en types om data en API-contracten te specificeren. - **Environment variables**: Beheer configuratie via `.env` bestanden en `dotenv`. - **Testing**: Voeg een teststructuur toe (bijvoorbeeld met Jest). - **Linter en formatter**: Gebruik ESLint en Prettier voor consistente code. ### 4. Samenvatting - Maak een `tsconfig.json` met strikte compileropties zoals `strict`, `esModuleInterop`, en `sourceMap`. - Organiseer je code in duidelijke mappen zoals `controllers`, `routes`, `services`, en `models`. - Plaats bronbestanden in `/src` en gecompileerde code in `/dist`. - Gebruik moderne JavaScript (ES2022) en module resolution voor optimale compatibiliteit. Door deze aanpak zorg je voor een schaalbaar, onderhoudbaar en efficiënt TypeScript backend project met Node.js en Express.

Zeker, hier is een uitgebreide uitleg over het configureren van een TypeScript-project voor een Node.js backend met Express. ### 1. tsconfig.json Configuratie Maak een `tsconfig.json` bestand in de root van je project: ```json { "compilerOptions": { "target": "ES2022", "module": "commonjs", "lib": ["ES2022"], "moduleResolution": "node", "rootDir": "./src", "outDir": "./dist", "removeComments": true, "strict": true, "esModuleInterop": true, "skipLibCheck": true, "forceConsistentCasingInFileNames": true, "resolveJsonModule": true, "declaration": false, "noUnusedLocals": true, "noUnusedParameters": true, "exactOptionalPropertyTypes": true, "noImplicitReturns": true, "noFallthroughCasesInSwitch": true }, "include": ["src/**/*"], "exclude": ["node_modules", "dist", "**/*.test.ts"] } ``` **Belangrijkste opties uitgelegd:** - `target`: ES2022 voor moderne Node.js versies - `module`: commonjs voor Node.js compatibiliteit - `strict`: enabled voor maximale type safety - `esModuleInterop`: vereist voor Express imports - `rootDir`/`outDir`: scheiding source en build files ### 2. Projectstructuur voor Schaalbaarheid ``` project-root/ ├── src/ │ ├── controllers/ # Route handlers │ │ ├── userController.ts │ │ └── authController.ts │ ├── services/ # Business logic │ │ ├── userService.ts │ │ └── authService.ts │ ├── models/ # Data modellen/interfaces │ │ ├── userModel.ts │ │ └── databaseModels.ts │ ├── middleware/ # Custom middleware │ │ ├── authMiddleware.ts │ │ └── validationMiddleware.ts │ ├── routes/ # Route definities │ │ ├── userRoutes.ts │ │ └── authRoutes.ts │ ├── utils/ # Hulpfuncties │ │ ├── logger.ts │ │ └── helpers.ts │ ├── config/ # Configuratiebestanden │ │ ├── database.ts │ │ └── environment.ts │ └── app.ts # Hoofdapplicatie ├── dist/ # Compiled JavaScript (gegenereerd) ├── tests/ # Testbestanden ├── package.json ├── tsconfig.json └── .env ``` ### 3. Package.json Scripts ```json { "scripts": { "build": "tsc", "start": "node dist/app.js", "dev": "ts-node-dev --respawn --transpile-only src/app.ts", "clean": "rm -rf dist", "lint": "eslint src/**/*.ts" } } ``` ### 4. Basis Express Setup Voorbeeld **src/app.ts:** ```typescript import express from 'express'; import { config } from './config/environment'; import { connectDatabase } from './config/database'; import { requestLogger } from './middleware/loggerMiddleware'; const app = express(); // Middleware app.use(express.json()); app.use(requestLogger); // Routes app.use('/api/users', require('./routes/userRoutes')); app.use('/api/auth', require('./routes/authRoutes')); // Health check app.get('/health', (req, res) => { res.status(200).json({ status: 'OK' }); }); // Database connectie connectDatabase(); const PORT = config.port || 3000; app.listen(PORT, () => { console.log(`Server running on port ${PORT}`); }); export default app; ``` ### 5. Best Practices voor Onderhoudbaarheid 1. **Environment Configuratie:** ```typescript // src/config/environment.ts export const config = { port: process.env.PORT || 3000, nodeEnv: process.env.NODE_ENV || 'development', databaseUrl: process.env.DATABASE_URL || '' }; ``` 2. **Dependency Injection:** Gebruik containers voor testbaarheid 3. **Error Handling:** Centrale error handling middleware 4. **Logging:** Structured logging met Winston of Pino 5. **Testing:** Separeer testbestanden in `/tests` map ### 6. Aanvullende Development Tools Installeer: ```bash npm install -D @types/node @types/express typescript ts-node-dev eslint ``` Deze setup biedt een solide foundation voor een schaalbare en onderhoudbare TypeScript Express backend!