tsconfig.json

TypeScript 🟢 Junior

Définition

Fichier de configuration central d'un projet TypeScript : options du compilateur, fichiers inclus, résolution des modules. Depuis TypeScript 6.0 (23 mars 2026), les valeurs par défaut ont changé : strict à true, module à esnext, target à es2025, types à [] et rootDir au dossier du tsconfig. TypeScript 7.0 (8 juillet 2026) supprime target es5, baseUrl, moduleResolution classic/node10 et les modules amd/umd/systemjs.

Analogie

Comme le tableau de bord d'une voiture — tous les réglages du moteur TypeScript en un seul endroit.

Exemple de code

{
  "compilerOptions": {
    "target": "es2025",
    "module": "nodenext",
    "strict": true,
    "types": ["node"],
    "erasableSyntaxOnly": true,
    "verbatimModuleSyntax": true,
    "outDir": "dist"
  },
  "include": ["src"]
}

Cas d'usage

Tout projet TypeScript commence par un tsconfig. Depuis 5.9, tsc --init génère un fichier minimal et prescriptif plutôt qu'un gabarit exhaustif commenté.

Anti-pattern

Copier un tsconfig d'avant la 6.0 sans relire les options : baseUrl est déprécié et types n'inclut plus tous les @types (ajouter "types": ["node"] pour un projet Node).
#core#tooling#beginner#ts6#ts7

Fiche mise à jour le 2026-09-27

← → au clavier pour passer d'une fiche à l'autre