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 Utilisateurne 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 enunknown) et pour la donnée validée. Les confondre fait disparaître la frontière du code.
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.