Formations — 1 037 leçons en français

Accueil › TypeScript › Les options qui comptent

Les options qui comptent

Configurer le compilateurintermediaire

Un tsconfig.json à la racine suffit pour que tsc sache quoi faire :

{
  "compilerOptions": {
    "strict": true,
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "outDir": "dist",
    "skipLibCheck": true
  },
  "include": ["src"]
}

strict n'est pas une vérification

C'est un regroupement. strict: true active par défaut une famille d'options nommées, et chacune reste réglable :

{
  "compilerOptions": {
    "strict": true,
    "strictPropertyInitialization": false
  }
}

Cette configuration est valide. L'option explicite l'emporte sur la valeur héritée du regroupement — on garde donc strictNullChecks et noImplicitAny tout en désactivant le seul membre qui gêne. Renoncer à strict entier parce qu'un de ses membres dérange est un mauvais calcul.

Le membre qui change tout

function longueur(s: string | null) {
  return s.length;        // ❌ TS18047 : « s » est peut-être « null »
}

Sans strictNullChecks, null et undefined sont assignables à n'importe quel type et cette ligne ne produit aucune erreur. La majorité des bogues que TypeScript évite viennent de cette seule option.

Les fichiers du projet

include filtre par motif, exclude retire de ce qu'include a trouvé, files liste explicitement. exclude n'empêche jamais un fichier d'être compilé s'il est importé par un fichier inclus : il ne fait que le retirer du point de départ.

Le compilateur comme vérificateur

tsc --noEmit

L'outil qui construit votre application retire souvent les types sans les vérifier. tsc --noEmit est alors le seul vérificateur du projet, et sa place est dans l'intégration continue.

Les termes à connaître

tsconfig.json

Le fichier qui déclare les options du compilateur et les fichiers du projet. Sa présence à la racine suffit à faire de tsc une commande sans argument.

strict

Une option de regroupement. Elle n'ajoute aucune vérification propre : elle active par défaut une famille d'options nommées, que l'on peut désactiver une par une.

strictNullChecks

Le membre le plus important de la famille. Sans elle, null et undefined appartiennent à tous les types et aucune erreur d'accès n'est signalée.

noImplicitAny

Signale les valeurs dont le compilateur n'a pu déduire aucun type et qui deviennent any en silence.

include / exclude / files

Les trois façons de désigner les fichiers du projet. files liste, include filtre par motif, exclude retire de ce qu'include a trouvé.

tsc --noEmit

Lance la vérification de types sans produire de fichier. C'est la forme utilisée en intégration continue.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.