Formations — 1 037 leçons en français

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 Depot ou as 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 Partial de 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 par undefined lors de la fusion. exactOptionalPropertyTypes est 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.

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.