Ce guide présente les bonnes pratiques pour rédiger des étapes de test que Thunders exécute sans ambiguïté.
​
Une étape bien rédigée décrit ce qu'un utilisateur réel voit et fait à l'écran : une action claire, des libellés exacts et un résultat attendu vérifiable. Ces bonnes pratiques vous donnent des tests fiables : quand une étape échoue, c'est que votre application a changé, pas que l'étape était floue.

1️⃣ Écrivez comme un utilisateur réel

❌ Déclencher la fonction onSubmit
❌ Valider le formulaire

Ces formulations décrivent ce que fait le code, pas ce que fait l'utilisateur. L'IA a besoin d'actions visibles à l'écran.

À utiliser :

✓ Cliquer sur le bouton 'Connexion'

2️⃣ Une étape = une seule action

❌ Cliquer sur le bouton 'Connexion', entrer "[email protected]" dans le champ 'E-mail' et vérifier que le message d'erreur s'affiche

Cette étape combine deux actions et une vérification. Si une partie échoue, impossible de savoir laquelle, et l'IA risque de n'en exécuter qu'une partie.

À utiliser :

✓ Cliquer sur le bouton 'Connexion'
​✓ Entrer "[email protected]" dans le champ 'E-mail'
​✓ Vérifier que le message d'erreur s'affiche

3️⃣ Une phrase = une action observable

❌ M'authentifier
❌ Remplir le formulaire

Ce sont des intentions, pas des actions. Si vous ne pouvez pas voir ou effectuer l'action à l'écran, elle est trop abstraite pour l'IA.

À utiliser :

✓ Entrer "[email protected]" dans le champ 'E-mail'

4️⃣ Nommez les éléments tels qu'ils apparaissent à l'écran

❌ Cliquer sur le bouton principal
❌ Cliquer sur l'icône
❌ Remplir le champ 1

Une référence générique oblige l'IA à deviner. Utilisez le libellé visible dans l'interface. S'il n'y a pas de texte, décrivez la couleur, l'icône ou la position.

À utiliser :

✓ Cliquer sur le bouton 'Connexion'
​✓ Cliquer sur l'icône crayon à côté du nom de l'utilisateur
​✓ Cliquer sur le bouton bleu 'Enregistrer' en haut à droite

5️⃣ Utilisez un vocabulaire cohérent

Choisissez un verbe par type d'action et gardez-le dans tous vos cas de test.

💡 Cohérence = meilleurs tests générés.

6️⃣ Décrivez l'intention, pas la mise en œuvre

❌ Entrer une valeur non valide dans le backend

L'utilisateur ne voit pas le backend. Restez dans sa perspective : ce qu'il tape, clique ou observe.

À utiliser :

✓ Entrer un mot de passe incorrect dans le champ 'Mot de passe'

7️⃣ Incluez les états intermédiaires

❌ Créer un compte pour le nouvel utilisateur

Cette formulation saute toutes les étapes observables : aller sur la page d'inscription, remplir chaque champ, valider le formulaire et vérifier le message de confirmation. L'IA ne peut pas automatiser ce qu'elle ne voit pas.

À utiliser :

✓ Naviguer vers la page d'inscription

✓ Entrer "John" dans le champ 'Prénom'

✓ Entrer "[email protected]" dans le champ 'E-mail'

✓ Cliquer sur le bouton 'Créer un compte'

✓ Vérifier que le message de confirmation s'affiche

8️⃣ Anticipez les cas négatifs

❌ Ne rédiger que le scénario idéal : Entrer des identifiants valides et cliquer sur 'Connexion'

Ne tester que ce qui doit fonctionner laisse de grandes lacunes dans la couverture. L'IA gère aussi bien les cas négatifs, à condition que vous les écriviez.

À utiliser :

✓ Cliquer sur le bouton 'Connexion' sans remplir aucun champ
​✓ Entrer une adresse e-mail non valide dans le champ 'E-mail'
​✓ Cliquer deux fois rapidement sur le bouton 'Soumettre'

9️⃣ Si l'IA ne peut pas le vérifier, reformulez

❌ Comprendre que l'erreur est claire
❌ La page semble correcte

Ces formulations demandent un jugement humain : il n'y a rien de concret à vérifier. Une étape n'est testable que si elle décrit quelque chose de visible ou de mesurable.

À utiliser :

✓ Vérifier que le message "Identifiants non valides" s'affiche sous le champ 'E-mail'
​✓ Vérifier que le nom de l'utilisateur est visible en haut à droite

Cet exemple applique les neuf règles dans un seul cas de test. Utilisez-le comme référence pour rédiger les vôtres.

✓ 1. Naviguer vers la page de connexion

✓ 2. Entrer "[email protected]" dans le champ 'E-mail'

✓ 3. Entrer "password123" dans le champ 'Mot de passe'

✓ 4. Cliquer sur le bouton 'Connexion'

✓ 5. Vérifier que la page 'Tableau de bord' s'affiche

✓ 6. Vérifier que le nom "John Doe" est visible en haut à droite

Pourquoi cela fonctionne :

Trop vague

❌

1. Faire défiler la page
2. Soumettre
3. Voir une erreur

« La page » et « une erreur » ne donnent à l'IA aucun élément à cibler. Les étapes 1 et 2 sont des actions, mais l'étape 3 est un résultat attendu qui n'est pas écrit comme une vérification.

✓

1. Naviguer vers la page de connexion
2. Entrer "[email protected]" dans le champ 'E-mail'
3. Entrer "wrongPassword" dans le champ 'Mot de passe'
4. Cliquer sur le bouton 'Connexion'
5. Vérifier que le message "Identifiants non valides" s'affiche
6. Vérifier que la page de connexion reste affichée

Actions, vérifications et détails techniques mélangés

❌

1. Cliquer sur le bouton principal pour envoyer le formulaire
2. Le backend renvoie une erreur
3. Le message s'affiche correctement

Le « bouton principal » n'est pas un libellé visible. « Le backend » est un détail technique. « Correctement » n'est pas vérifiable.

✓

1. Cliquer sur le bouton 'Connexion'
2. Vérifier que le message "Identifiants non valides" s'affiche
3. Vérifier que la page d'accueil ne s'affiche pas

Trop abstrait

❌

1. S'authentifier avec des identifiants non valides

Cette étape décrit une intention et saute toutes les actions observables intermédiaires. L'IA ne peut pas deviner quels champs existent, quoi saisir ni quoi vérifier.

✓

1. Entrer une adresse e-mail non valide dans le champ 'E-mail'
2. Entrer un mot de passe incorrect dans le champ 'Mot de passe'
3. Cliquer sur le bouton 'Connexion'
4. Vérifier qu'un message d'erreur s'affiche

Si un nouveau collègue ne peut pas exécuter l'étape à la main à partir de sa seule description, l'IA aura probablement du mal aussi.

→Comment générer des étapes de test ?

→Modifier les étapes du cas de test