Formations — 1 037 leçons en français

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 retire null et undefined du 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 strictNullChecks activé : vous lisez une propriété sur une valeur dont le type inclut undefined.

`?.` (chaînage optionnel)

Court-circuite l'accès et renvoie undefined si la valeur à gauche est null ou undefined. 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 null ou undefined. Contrairement à ||, il laisse passer 0, "" et false.

Propriété optionnelle `?`

age?: number signifie que la clé peut être absente : le type est number | undefined. Ce n'est pas la même chose que age: number | undefined, où la clé doit être écrite.

Assertion non nulle `!`

x! affirme au compilateur que x n'est ni null ni undefined. Rien n'est vérifié à l'exécution : c'est une promesse, pas un contrôle.

`exactOptionalPropertyTypes`

Une option hors de strict qui distingue « clé absente » de « clé présente valant undefined ». Utile quand l'absence et la valeur nulle ont des sens différents côté serveur.

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.