Pourquoi le Test Data Builder ?

On a tous écrit des tests où l’étape Arrange devient un roman: 12 paramètres, des nulls partout, et des valeurs qui n’intéressent pas le test. Le Test Data Builder (TDB) sert à ça: donner des valeurs par défaut cohérentes, et ne surcharger que ce qui est pertinent pour le scénario.

Le principe en 30 secondes

On crée une classe Builder avec des valeurs par défaut valides. Dans le test, on customise juste ce qui compte via une API fluide (WithXyz), puis on appelle Build() pour obtenir l’objet final.

Diagramme rapide

Implémentation d’un builder simple

Usage dans un test xUnit

Builders imbriqués (optionnel)

Pièges et conseils

- Gardez des valeurs par défaut valides et proches du réel: vos tests seront plus représentatifs.

- Chaque test ne change QUE ce qui compte pour son intention. Le reste reste implicite dans le builder.

- Évitez de mettre de la logique métier dans le builder. Il construit des données, point.