Accueil › TypeScript › null, undefined et strictNullChecks
null, undefined et strictNullChecks
Les types de basedebutant
Sans strictNullChecks, null et undefined habitent tous les types :
une valeur annotée string peut valoir null, et le compilateur ne dit rien.
C'est le défaut historique, et c'est la source de la majorité des
TypeError: cannot read properties of undefined.
Avec strictNullChecks — inclus dans strict: true — ils sortent du domaine
des autres types et doivent être déclarés :
let nom: string = null; // TS2322: Type 'null' is not assignable
// to type 'string'.
let prenom: string | null = null; // d'accord
Et toute lecture est contrôlée :
function initiale(nom: string | undefined): string {
return nom[0];
// TS18048: 'nom' is possibly 'undefined'.
}
Les trois façons de traiter le cas
// 1. Garde explicite — la plus claire, et elle affine le type après
if (nom === undefined) return "?";
return nom[0];
// 2. Chaînage optionnel pour lire sans risque
return nom?.[0] ?? "?";
// 3. Valeur de repli à la frontière, une fois pour toutes
const sur = nom ?? "";
?. lit sans lever ; ?? fournit le repli. Les deux ensemble couvrent
la quasi-totalité des cas. Ce qu'il ne faut pas faire, c'est nom! : cela fait
taire le compilateur sans rien vérifier.
Les termes à connaître
- `strictNullChecks`
L'option, incluse dans
strict, qui retirenulletundefineddu domaine de tous les autres types. C'est celle qui attrape le plus de bogues réels dans un code existant.- TS18048
« 'x' is possibly 'undefined' ». Le message le plus fréquent une fois
strictNullChecksactivé : vous lisez une propriété sur une valeur dont le type inclutundefined.- `?.` (chaînage optionnel)
Court-circuite l'accès et renvoie
undefinedsi la valeur à gauche estnullouundefined. Il lit sans risque ; il ne fournit pas de valeur de repli.- `??` (coalescence nulle)
Renvoie l'opérande de droite uniquement si celui de gauche est
nullouundefined. Contrairement à||, il laisse passer0,""etfalse.- Propriété optionnelle `?`
age?: numbersignifie que la clé peut être absente : le type estnumber | undefined. Ce n'est pas la même chose queage: number | undefined, où la clé doit être écrite.- Assertion non nulle `!`
x!affirme au compilateur quexn'est ninullniundefined. Rien n'est vérifié à l'exécution : c'est une promesse, pas un contrôle.- `exactOptionalPropertyTypes`
Une option hors de
strictqui distingue « clé absente » de « clé présente valantundefined». Utile quand l'absence et la valeur nulle ont des sens différents côté serveur.
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.