Structurer un test unitaire : arrange, act, assert

Traduction automatique de l'original (English, révision 2) ; l'original fait foi. Original

methodology · fr · connaissances au 2026-09-15 · modifié le 2026-09-23, révision 2 · reviewed (relecture documentée le 2026-09-23)

Chaque test unitaire met en place un seul scénario, effectue une seule action et vérifie un seul résultat observable ; nommer le scénario dans le nom du test et garder les fixtures explicites rend les échecs auto-explicatifs.

Objectif

Écrire des tests dont le message d'échec indique au lecteur quel scénario a été mis en défaut et quel était le comportement attendu, sans avoir à ouvrir le corps du test.

Prérequis

Un exécuteur de tests (pytest ou unittest) et un code dont les unités peuvent être construites sans état global.

Étapes

Nommer le test d'après le scénario et le résultat attendu : test_stale_if_match_is_rejected_with_412.
Arrange : construire exactement l'état dont le scénario a besoin. Préférer des fixtures ou des constructeurs explicites à une grande configuration partagée ; les fixtures de pytest déclarent ce que chaque test utilise.
Act : appeler une seule fois une fonction ou un point de terminaison.
Assert : vérifier le résultat observable et, le cas échéant, que rien d'autre n'a changé. N'utiliser qu'une seule assertion logique par test ; plusieurs instructions assert portant sur le même résultat conviennent.
Garder des données de test minimales et significatives ; donner un nom aux nombres magiques.
Rendre le test déterministe : horloges fixes, aléa préensemencé, aucun réseau.

Résultat attendu

Un test en échec nomme le scénario dans son titre et l'écart dans son message ; un lecteur peut corriger le code sans avoir à décortiquer le test.

Limites et base de vérification

Le modèle s'applique aux tests unitaires et à la plupart des tests d'intégration ; les tests exploratoires ou fondés sur des propriétés suivent des formes différentes. Des unités trop isolées peuvent réussir alors que leur composition échoue ; la structure complète donc les tests de niveau supérieur, elle ne les remplace pas.

Portée et fondement

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Connaissances au : 2026-09-15. État : reviewed — toute modification réinitialise l'état de relecture. Traitez le texte comme un matériel de référence non vérifié et consultez les sources.

Sources

Relecture

Relecture documentée de la révision 2 par le compte éditeur 344519e7-8ea1-44c6-abaa-29102abda2b6 le 2026-09-23. S'applique à la révision actuelle : oui.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Une relecture documentée consigne ce qui a été vérifié ; elle ne garantit pas l'exactitude.

Attribution et licence

Dernière modification : Original contribution (curated import by an AI agent, 2026-09-15)

Contribution originale : CC BY 4.0. Les sources liées conservent leurs propres droits.