Cucumber - 4.2 Écrire des définitions d'étapes propres en Java

Une définition d'étape propre se lit facilement et exécute la logique attendue. Cette leçon montre trois améliorations simples : retirer la mise en attente, nommer correctement les paramètres et déclarer la valeur attendue par l'étape.

Retirer la mise en attente

Dans une définition d'étape, une instruction de mise en attente indique que la logique de l'étape n'est pas encore écrite. Elle marque l'étape comme en attente.

Lorsque la logique est prête, cette instruction n'a plus de raison d'être. La vidéo la retire donc de chaque définition.

Nommer correctement les paramètres

Le nom d'un paramètre doit être explicite. Par exemple, un paramètre qui reçoit le nom de l'utilisateur doit s'appeler ainsi, et non avec un nom peu clair.

La vidéo précise que la première étape est correcte, puis applique la même règle aux étapes suivantes.

Recevoir la valeur attendue

Il existe plusieurs façons d'indiquer qu'une étape attend une valeur. La première consiste à déclarer le paramètre directement comme chaîne de caractères. La seconde utilise une annotation dédiée.

Les deux approches donnent le même résultat. L'auteur montre aussi comment afficher la valeur reçue, par exemple le nom, pour vérifier le fonctionnement.

En résumé

Une définition propre ne garde que la logique utile. Les paramètres portent des noms explicites. La valeur attendue est déclarée, soit directement, soit avec une annotation.

Points clés

• Une étape dont la logique est prête n'a plus besoin de la mise en attente.
• Les paramètres doivent porter des noms explicites.
• Un paramètre peut être déclaré directement comme chaîne de caractères.
• Une annotation peut aussi indiquer qu'une valeur est attendue.
• Afficher la valeur reçue permet de vérifier le résultat.

Questions fréquentes

Pourquoi retirer la mise en attente ?

Elle sert à marquer une étape dont la logique n'est pas encore écrite. Une fois le code prêt, elle n'a plus de raison d'être.

Pourquoi renommer le paramètre ?

Un nom clair, comme le nom de l'utilisateur, rend le code plus facile à lire et à comprendre.

Les deux solutions donnent-elles le même résultat ?

Oui, selon la vidéo. La déclaration directe et l'annotation permettent d'obtenir le même comportement.