Accueil › TypeScript › Doubles et jeux de données typés
Doubles et jeux de données typés
Tester du TypeScriptavance
Un double doit être annoté par le vrai type. C'est la seule façon qu'il casse quand l'interface bouge.
interface Depot {
lire(id: string): Client | null;
enregistrer(c: Client): void;
}
// ✅ confronté au contrat à chaque compilation
const depot: Depot = {
lire: vi.fn().mockReturnValue(null),
enregistrer: vi.fn(),
};
// ❌ ne sera plus jamais confronté à rien
const depot = { lire: vi.fn() } as unknown as Depot;
Retirez enregistrer de Depot : la première version échoue — TS2353,
propriété inconnue — et vous supprimez un test devenu inutile. La seconde reste
verte, et vérifie un comportement qui n'existe plus.
Pour les jeux de données, une fabrique qui prend un Partial :
const DEFAUTS: Client = { id: "c1", nom: "Astra", actif: true };
export function unClient(p: Partial<Client> = {}): Client {
return { ...DEFAUTS, ...p };
}
unClient(); // un client valide
unClient({ actif: false }); // le seul champ qui intéresse ce test
L'ajout d'un champ obligatoire à Client casse une ligne : DEFAUTS. Sans
fabrique, il casse la compilation de chaque test qui écrit un client littéral,
pour une raison qui n'est le sujet d'aucun.
Un test doit nommer ce qui l'intéresse, et rien d'autre. Tout le reste appartient à la fabrique.
Les termes à connaître
- Double typé par le vrai type
Un objet de test annoté par l'interface réelle. La suppression ou le renommage d'un membre casse la compilation du test au lieu de le laisser passer.
- Double échappé
as unknown as Depotouas any: le double n'est plus confronté à l'interface, et survit à toutes ses évolutions. C'est un test qui a cessé de protéger.- Fabrique de jeu de données
Fonction qui prend un
Partialde l'entité et rend l'entité complète. Un champ ajouté se déclare une fois, dans les valeurs par défaut.- Fusion superficielle
{ ...defauts, ...fragment }ne copie qu'un niveau : les objets imbriqués restent partagés par référence entre tous les appels.- Défauts partagés mutés
Un objet de défauts déclaré au niveau du module et muté par un test contamine les suivants. L'échec apparaît alors ailleurs, et dépend de l'ordre d'exécution.
- undefined explicite
Un fragment contenant
{ nom: undefined }écrase le défaut parundefinedlors de la fusion.exactOptionalPropertyTypesest l'option qui le fait refuser.- satisfies pour un double
Vérifie la conformité du double à l'interface tout en conservant son type littéral, donc l'accès aux méthodes d'espionnage du double.
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.