Accueil › TypeScript › Dériver le type du validateur
Dériver le type du validateur
Gardes de type et assertionsavance
Le chapitre précédent écrivait les gardes à la main. Cela marche, mais la même donnée est alors décrite deux fois :
type Utilisateur = { id: string; nom: string; age: number };
function estUtilisateur(x: unknown): x is Utilisateur {
const o = x as Record<string, unknown>;
return typeof o.id === "string" && typeof o.nom === "string";
// ^ age n'est pas testé, et rien ne le dit
}
Ajouter un champ au type ne touche pas la garde. Ajouter un test à la garde ne
touche pas le type. Les deux dérivent, et le compilateur ne voit rien : la
signature x is Utilisateur est une promesse, pas une vérification.
Une seule description
import { z } from "zod";
const Utilisateur = z.object({
id: z.string(),
nom: z.string(),
age: z.number(),
});
type Utilisateur = z.infer<typeof Utilisateur>;
// ^? { id: string; nom: string; age: number }
Le schéma est une valeur : il existe à l'exécution et peut vérifier. Le type s'en déduit. Ajouter un champ au schéma modifie les deux d'un coup, et un accès devenu invalide ailleurs devient une erreur de compilation.
La dérivation va du vérifiable vers le déclaratif. Un type disparaît à la compilation ; il ne peut rien produire à l'exécution. L'inverse est mécanique.
Les termes à connaître
- Double source de vérité
Un type écrit à la main et un validateur écrit à la main décrivent la même donnée. Les deux dérivent, et la divergence ne produit aucune erreur de compilation.
- Type dérivé
Le type obtenu depuis le validateur —
z.infer<typeof Schema>,v.InferOutput<typeof Schema>. Le schéma devient la source unique, et le type suit.- Sens de la dérivation
Toujours du vérifiable vers le déclaratif. Le schéma existe à l'exécution, le type non : seul le premier peut produire le second.
- Type d'entrée et type de sortie
Un schéma qui transforme — valeur par défaut, conversion de date — a deux types distincts. Confondre les deux fait écrire des champs optionnels là où la sortie les garantit.
- `satisfies` pour vérifier un schéma
Quand le type est imposé de l'extérieur,
schema satisfies Schema<MonType>fait échouer la compilation si le schéma s'en écarte, sans le remplacer.- Coût d'une bibliothèque de schémas
Du code dans le bundle et une dépendance à suivre. Le gain est réel à la frontière ; il est nul pour une donnée que le programme produit lui-même.
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.