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
tscune 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,
nulletundefinedappartiennent à 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
anyen silence.- include / exclude / files
Les trois façons de désigner les fichiers du projet.
filesliste,includefiltre par motif,excluderetire de ce qu'includea trouvé.- tsc --noEmit
Lance la vérification de types sans produire de fichier. C'est la forme utilisée en intégration continue.
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.