Configurer TypeScript avec tsconfig

Objectifs

À la fin de cette leçon, vous saurez :

• lire un tsconfig.json section par section ;
• comprendre strict et ses sous-options ;
• organiser src/ et dist/ proprement.

🔗 Pour vous rafraîchir la mémoire : les bases TypeScript · package.json et scripts npm

Le squelette d'une configuration sérieuse

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "sourceMap": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"]
}

strict : pourquoi tout activer

"strict": true active le paquet de vérifications :

// strictNullChecks : null n'est plus invisible
let nom: string = trouverNom();        // ❌ peut renvoyer null

// noImplicitAny : pas de type deviné en silence
function traiter(d) { ... }            // ❌ paramètre implicite any

Sans strict, TS ressemble à un JS avec suggestions. Avec strict, chaque point faible est explicite — c'est là que vivent les vrais gains. Les projets sans strict accumulent une dette de typage impossible à rattraper.

La structure qui en découle

projet/
├── src/
│   ├── index.ts          ← rootDir
│   └── services/
├── dist/
│   ├── index.js          ← outDir (généré, gitignore)
│   └── services/
└── tsconfig.json

.gitignore : dist/
scripts npm :
  build     → tsc
  start     → node dist/index.js
  dev       → tsx watch src/index.ts
  typecheck → tsc --noEmit

Adapter la cible

target ne change PAS ce que vous écrivez : il décrit ce que le JS produit peut utiliser. ES2022 pour Node moderne ; ES2017+ si compatibilité navigateurs anciens exigée. Plus la cible monte, moins le compilateur réécrit — code produit plus proche du source.

Exercice

1. Créez un mini-projet avec cette configuration ; vérifiez l'arborescence dist/.
2. Désactivez strict temporairement : trouvez un bug que strict attrapait.
3. Ajoutez sourceMap puis déboguez un fichier dist avec breakpoint dans le .ts.
4. Pourquoi dist/ ne se versionne-t-il jamais ?

Résumé

• target/module/outDir/rootDir = où et comment compiler ; strict = à quel point vérifier.
• src/ source, dist/ généré ; sourceMap relie les deux au débogage.
• Quatre scripts npm suffisent : build, start, dev, typecheck.