Comment rédiger des étapes de test efficaces dans Thunders

Ce guide présente les meilleures pratiques pour rédiger des étapes de test que Thunders AI peut exécuter de manière fiable.

Des étapes bien rédigées décrivent ce qu'un utilisateur réel voit et fait à l'écran, avec des actions claires, des étiquettes d'interface utilisateur visibles et des résultats attendus vérifiables.

Le respect de ces pratiques vous aide à éviter les tests instables, à réduire l'ambiguïté et à tirer le meilleur parti de la génération d'étapes alimentée par l'IA.

1️⃣ Écrivez toujours comme un utilisateur réel.

❌ Déclencher la fonction onSubmit

❌ Valider le formulaire

Ces éléments décrivent ce que fait le code, et non ce que fait un utilisateur à l'écran. L'IA a besoin d'actions humaines visibles pour exécuter une étape, et non de détails techniques de mise en œuvre.

Utilisation :

✓ Cliquez sur le bouton « Se connecter »

2️⃣ Chaque étape doit décrire une seule action.

❌ Cliquez sur le bouton Connexion, remplissez le champ E-mail avec « [email protected] » et vérifiez que le message d'erreur s'affiche

Cela combine deux actions et une vérification en une seule étape. Si l'une des parties échoue, il est impossible de savoir laquelle en est la cause, et l'IA peut n'en exécuter qu'une partie.

Utilisation :

✓ Cliquez sur le bouton Connexion

✓ Entrez « [email protected] » dans le champ E-mail

✓ Vérifiez que le message d'erreur s'affiche (en tant que résultat attendu distinct)

3️⃣ Une phrase = une action observable.

❌ M'authentifier

❌ Remplir le formulaire

Ces actions décrivent des intentions, et non des actions visibles. Si vous ne pouvez pas les voir ou les effectuer physiquement à l'écran, elles sont trop abstraites pour que l'IA puisse agir.

Utilisation :

✓ Entrez « [email protected] » dans le champ E-mail

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

❌ Cliquez sur le bouton principal

❌ Cliquez sur l'icône

❌ Remplissez le champ 1

Les références génériques ne donnent aucun repère à l'IA, qui va devoir deviner et risque de se tromper. Utilisez toujours le libellé exact visible dans l'interface utilisateur. En l'absence de libellé textuel, décrivez la couleur, l'icône ou la position.

Utilisez :

✓ Cliquez sur le bouton « Connexion »

✓ Cliquez sur l'icône en forme de crayon à côté du nom de l'utilisateur

✓ Cliquez sur le bouton bleu « Enregistrer » dans le coin supérieur droit

5️⃣ Utilisez un vocabulaire cohérent

Choisissez un verbe par type d'action et essayez de rester cohérent dans vos cas de test :

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

❌ Entrer une valeur non valide dans le backend

Cela fait référence à des éléments internes du système qu'un utilisateur ne peut ni voir ni manipuler. Les étapes doivent rester dans la perspective de l'utilisateur : ce qu'il tape, clique ou observe.

Utilisation :

✓ Entrez un mot de passe incorrect dans le champ Mot de passe

7️⃣ Incluez les états intermédiaires importants

❌ Créer un compte pour le nouvel utilisateur

Cela permet d'éviter toutes les étapes observables : navigation vers la page d'inscription, remplissage de chaque champ, soumission du formulaire et vérification du message de confirmation. L'IA ne peut pas automatiser ce qu'elle ne peut pas voir.

Utilisation :

✓ Accédez à 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érifiez que le message de confirmation s'affiche

8️⃣ Anticipez les cas négatifs lorsque vous rédigez.

❌ Ne rédigez que le scénario idéal : entrez des identifiants valides et cliquez sur Connexion

Tester uniquement ce qui devrait fonctionner laisse de grandes lacunes dans la couverture. L'IA gère aussi bien les cas négatifs que les cas positifs, mais uniquement si vous les écrivez.

Utilisation :

✓ Cliquez sur le bouton Connexion sans remplir aucun champ

✓ Entrez une adresse e-mail non valide dans le champ E-mail

✓ Cliquez deux fois rapidement sur le bouton Soumettre

9️⃣ Si l'IA ne peut pas l'automatiser, reformulez-le.

❌ Comprenez que l'erreur est claire

❌ La page semble correcte

Ces éléments nécessitent un jugement et une interprétation humains, il n'y a rien de concret à vérifier. Une étape n'est testable que si elle décrit quelque chose de visible, de mesurable ou de présent à l'écran.

Utilisation :

✓ Un message d'erreur « Identifiants non valides » s'affiche sous le champ E-mail.

✓ La page du tableau de bord s'affiche avec le nom de l'utilisateur dans le coin supérieur droit.

Cet exemple applique les neuf règles dans un seul cas de test. Utilisez-le comme référence lorsque vous rédigez le vôtre.

✓ 1. Accédez à la page de connexion

✓ 2. Saisissez « [email protected] » dans le champ E-mail

✓ 3. Entrez « password123 » dans le champ Mot de passe

✓ 4. Cliquez sur le bouton Connexion

✓ 5. Vérifiez que la page du tableau de bord s'affiche

✓ 6. Vérifiez que le nom d'utilisateur « John Doe » est visible dans le coin supérieur droit

Pourquoi cela fonctionne :

Trop vague

❌

1. Faites défiler la page

2. Soumettre

3. Voir une erreur

Rien ici n'est exploitable sans contexte clair. « La page » et « une erreur »... ne donnent à l'IA aucun élément fiable à cibler. Les étapes 1 à 3 sont des actions, mais l'étape 4 est un résultat attendu qui n'a pas été écrit comme tel.

✓

1. Accédez à la page de connexion.

2. Saisissez « [email protected] » dans le champ E-mail.

3. Saisissez « wrongPassword » dans le champ Mot de passe.

4. Cliquez sur le bouton Connexion.

5. Vérifiez qu'un message d'erreur « Identifiants non valides » s'affiche.

6. Vérifiez que la page de connexion reste affichée.

Mélange d'actions, de vérifications et de références techniques

❌

1. Cliquez sur le bouton principal pour envoyer le formulaire.

2. Le backend renvoie une erreur.

3. Le message s'affiche correctement.

« Bouton principal » n'est pas une étiquette UI visible. « Le backend renvoie une erreur » est un détail d'implémentation, pas une observation de l'utilisateur. « Le message s'affiche correctement » n'est pas vérifiable tel qu'il est écrit.

✓

1. Cliquez sur le bouton Connexion.

2. Vérifiez qu'un message d'erreur « Identifiants non valides » s'affiche.

3. Vérifiez que la page d'accueil ne s'affiche pas.

Trop abstrait

❌

1. Authentifiez-vous avec des identifiants non valides

Cette description décrit une intention en une seule étape, en omettant toutes les actions observables entre les deux. L'IA ne peut pas déduire quels champs existent, quelles valeurs saisir ou 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 vous ne pouvez pas confier une étape de test à un nouveau collègue et lui demander de l'exécuter manuellement à partir de sa seule description, l'IA pourrait également rencontrer des difficultés.