Formations — 1 037 leçons en français

Accueil › TypeScript › Valider à la frontière

Valider à la frontière

Gardes de type et assertionsavance

Tout ce que le programme n'a pas produit lui-même arrive sans type. Une réponse réseau, un localStorage, un process.env, un champ de formulaire : la seule information honnête est unknown.

const reponse = await fetch("/api/utilisateur");
const u = await reponse.json();
//    ^? any  — rien n'est vérifié, tout est permis
u.profil.nom.toUpperCase();     // ✅ compile, et casse en production

json() et JSON.parse rendent any. Le compilateur se tait, et la donnée non vérifiée traverse tout le programme.

Retyper en unknown, puis valider

const brut: unknown = await reponse.json();

if (!estUtilisateur(brut)) {
  throw new Error("Réponse /api/utilisateur invalide");
}
brut.profil;      // ✅ Utilisateur, pour de bon

Le : unknown est le geste décisif : il transforme le silence du compilateur en obligation. Tant qu'il est là, aucun accès n'est possible avant la garde.

La frontière est un lieu, pas une habitude

Validez une fois, à l'entrée, et traitez le reste du programme comme sûr. Revalider dans chaque fonction en aval signifie qu'on ne croit pas ses propres types — et chaque copie de la règle finit par diverger.

Un as à la frontière est la pire assertion possible. (await reponse.json()) as Utilisateur ne vérifie rien et supprime l'avertissement exactement là où le risque est maximal : sur une donnée venue d'ailleurs.

Les termes à connaître

Frontière

Chaque point où une donnée entre dans le programme sans avoir été produite par lui : réponse réseau, formulaire, localStorage, variable d'environnement, argument de ligne de commande, message d'un autre onglet.

Le mensonge de `JSON.parse`

Sa signature rend any. Le compilateur accepte donc tout ce qu'on en fait, et la donnée traverse le programme sans jamais avoir été vérifiée.

Valider une fois

Le principe : une seule frontière par source, un seul appel de garde, puis un type sûr à l'intérieur. Valider partout revient à n'avoir confiance nulle part.

Analyser plutôt que valider

Rendre la donnée typée plutôt qu'un booléen. La forme validée et la forme utilisée sont alors la même valeur, et il devient impossible d'oublier l'appel.

Rapport d'erreurs

Au lieu de false, la liste des chemins fautifs — ["adresse.ville", "id"]. C'est ce qui distingue un message utilisable d'un « données invalides ».

Type de frontière

Un type distinct pour la donnée brute (UtilisateurBrut, champs en unknown) et pour la donnée validée. Les confondre fait disparaître la frontière du code.

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.