Accueil › TypeScript › Tester les types eux-mêmes
Tester les types eux-mêmes
Tester du TypeScriptavance
Quand un module expose des types — une fonction générique, un type utilitaire, une signature publique — ces types sont une surface comme une autre, et ils peuvent régresser. On les teste par des assertions vérifiées à la compilation.
// selection.test-d.ts
import { expectTypeOf } from "vitest";
import { pluck } from "./selection";
const clients = [{ id: "c1", age: 30 }];
expectTypeOf(pluck(clients, "age")).toEqualTypeOf<number[]>();
expectTypeOf(pluck).parameter(1).toEqualTypeOf<"id" | "age">();
// @ts-expect-error une clé inexistante doit être refusée
pluck(clients, "taille");
Rien de tout cela ne s'exécute. expectTypeOf ne produit aucun code ; l'échec
est un diagnostic du compilateur. Il faut donc une commande qui le fasse lire :
vitest --typecheck # rapporte les erreurs de type comme des échecs
tsc --noEmit # suffit aussi, si le fichier est inclus
Le piège est une ligne d'apparence inoffensive :
// ❌ ce test ne peut plus échouer
expectTypeOf(pluck(clients, "age") as number[]).toEqualTypeOf<number[]>();
L'assertion impose la réponse attendue avant la comparaison. Le test est vert
quoi qu'il arrive — y compris après une régression qui ferait rendre any[] à
pluck.
Dans un test de type, un
asest toujours une erreur : il écrit la réponse à la place du code testé.
Les termes à connaître
- Test de type
Une assertion qui échoue à la compilation et non à l'exécution. Elle protège la signature publique d'un module, pas son comportement.
- expectTypeOf
Interface fluide de Vitest pour comparer des types. Elle ne produit aucun code exécuté : seul le vérificateur de types la lit.
- assertType
Affirme qu'une valeur est assignable à un type. Plus simple qu'
expectTypeOf, et plus permissive : l'assignabilité n'est pas l'identité.- Identité contre assignabilité
toEqualTypeOfexige deux types identiques ; une vérification d'assignabilité accepte tout sous-type, et laisse donc passer un type trop précis ou trop large.- ts-expect-error
Commentaire qui exige une erreur sur la ligne suivante. S'il n'y en a pas, la compilation échoue — c'est ce qui en fait une assertion négative utilisable comme test.
- Assertion qui désarme le test
Un
asdans un test de type impose la réponse attendue. L'assertion est toujours vérifiée, et le test ne peut plus échouer.- vitest --typecheck
Mode qui fait relire les fichiers de tests de types par le compilateur et rapporte ses erreurs comme des échecs de test.
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.