Prérequis
Avant d'ajouter une étape web, vous devez disposer d'un scénario de test existant.
Qu'est-ce qu'une Étape web ?
Une Étape web est une commande d'automatisation de navigateur explicite que vous définissez à l'aide :
une action (ce qu'il faut faire)
une description — une explication en langage naturel de l'étape
un type (comment identifier l'élément)
une valeur (le sélecteur ou la valeur proprement dite)
Utilisez-la lorsque vous avez besoin d'un contrôle total sur des pages complexes.
Quand l'utiliser
Ciblage complexe : les éléments sont difficiles à décrire en texte clair.
Structure instable : le texte et le contenu des éléments changent d'une visite à l'autre.
Chemins critiques : vous souhaitez un comportement prévisible et reproductible.
Ajouter une Étape web
Ouvrez votre scénario de test.
Cliquez sur Ajouter une nouvelle étape.
Dans Type d'étape, sélectionnez Étape web.
Configurez l'étape
Action : choisissez l'action à effectuer (par exemple : Cliquer, Saisir, Sélectionner, Cocher, Survoler, Faire défiler, Attendre que l'élément soit visible).
Description : ajoutez une brève explication claire et compréhensible décrivant ce que fait l'étape.
Type : sélectionnez comment l'élément est identifié — CSS, XPath, Étiquette ARIA, Texte.
Valeur : saisissez le sélecteur/la valeur correspondant(e)
Liste complète des actions des Étapes web
Vous trouverez ci-dessous une référence complète de toutes les actions web disponibles, classées par catégorie.
Navigation et gestion des onglets
Ces actions contrôlent la navigation dans les pages et le comportement des onglets. Aucun sélecteur n'est requis.
Action | Code | Description |
Go Back |
| Accéder à la page précédente dans l'historique du navigateur. |
Go Forward |
| Accéder à la page suivante dans l'historique du navigateur. |
Reload |
| Recharger la page actuelle. |
Switch To Tab |
| Passer à un onglet déjà ouvert dans le navigateur. Nécessite une valeur (index d'onglet ou identifiant). |
Open New Tab |
| Ouvrir un nouvel onglet du navigateur. Vous pouvez éventuellement fournir une URL comme valeur. |
En attente
Ces actions suspendent l'exécution jusqu'à ce qu'une condition soit remplie. Utile pour les pages dynamiques.
Action | Code | Description |
Wait For Timeout |
| Suspend l'exécution pendant une durée spécifiée (en ms). Nécessite une valeur (délai d'expiration en millisecondes). Aucun sélecteur n'est nécessaire. |
Wait For Selector |
| Attendre qu'un élément correspondant au sélecteur apparaisse dans le DOM. Nécessite un sélecteur. |
Wait For Load State |
| Attendre que la page atteigne un état de chargement spécifique (par exemple, |
Wait For URL |
| Attendre que l'URL de la page corresponde à un modèle spécifié. Nécessite une valeur (URL ou modèle d'URL). Aucun sélecteur n'est nécessaire. |
Interaction avec les éléments
Ces actions interagissent avec les éléments de la page. Toutes nécessitent un sélecteur, sauf indication contraire.
Action | Code | Description |
Click |
| Cliquez sur un élément. Nécessite un sélecteur. |
Double Click |
| Double-cliquez sur un élément. Nécessite un sélecteur. |
Right Click |
| Clic droit (menu contextuel) sur un élément. Nécessite un sélecteur. |
Middle Click |
| Clic central sur un élément (ouvre généralement le lien dans un nouvel onglet). Nécessite un sélecteur. |
Click At |
| Cliquez à des coordonnées spécifiques de la page. Nécessite des valeurs de coordonnées x et y à la place d'un sélecteur. |
Hover |
| Survolez un élément avec la souris. Nécessite un sélecteur. |
Drag |
| Faites glisser un élément et déposez-le sur un autre. Nécessite un sélecteur source et un sélecteur cible/des coordonnées comme valeur. |
Saisie et sélection
Ces actions permettent de remplir ou de modifier des champs de formulaire. Elles nécessitent toutes un sélecteur et, en général, une valeur.
Action | Code | Description |
Fill |
| Saisit du texte dans un champ de saisie (efface d'abord le contenu existant). Nécessite un sélecteur et une valeur (texte à saisir). |
Clear |
| Efface le contenu d'un champ de saisie. Nécessite un sélecteur. |
Press |
| Appuyer sur une touche ou une combinaison de touches du clavier (par exemple, |
Select |
| Sélectionnez une option dans une liste déroulante |
Open Dropdown |
| Ouvrir un élément de menu déroulant sans sélectionner. Nécessite un sélecteur. |
Check |
| Cochez une case à cocher ou un bouton radio. Nécessite un sélecteur. |
Uncheck |
| Désélectionner une case à cocher. Nécessite un sélecteur. |
Select Text |
| Sélectionner/mettre en surbrillance du texte dans un élément. Nécessite un sélecteur. |
Focalisation et état
Ces actions gèrent le focus et la visibilité des éléments.
Action | Code | Description |
Focus |
| Place le focus sur un élément. Nécessite un sélecteur. |
Blur |
| Retirer le focus d'un élément. Nécessite un sélecteur. |
Scroll Into View |
| Faire défiler la page jusqu'à ce que l'élément soit visible dans la fenêtre d'affichage. Nécessite un sélecteur. |
Capture d'écran et exportation
Ces actions vous permettent de capturer des instantanés visuels et d'exporter le contenu d'une page directement à partir d'une Étape web.
Action | Code | Description |
Screenshot (Viewport) |
| Capture une capture d'écran de la fenêtre d'affichage actuelle du navigateur. Ajoutez un sélecteur facultatif pour capturer un seul élément. |
Screenshot (Full Page) |
| Capture une capture d'écran de la page entière (y compris le contenu situé sous le pli). Aucun sélecteur requis. |
PDF Export |
| Exportez la page actuelle au format PDF. Chrome/Chromium uniquement. Aucun sélecteur requis. |
Extract File |
| Extraire des données structurées (par exemple, au format CSV) du contenu de la page. Prend en charge des options pour supprimer les colonnes vides, supprimer les lignes vides et limiter le nombre de lignes. Aucun sélecteur requis. |
Capturer une partie de la page
Pour capturer un seul élément au lieu de toute la fenêtre d'affichage, choisissez Screenshot (Viewport) et renseignez le champ Sélecteur (optionnel) avec le sélecteur de cet élément. Thunders capture alors uniquement l'élément que le sélecteur trouve. Laissez le champ vide pour capturer toute la fenêtre d'affichage.
Options de l'extraction de fichier
Lorsque vous choisissez Extract File, saisissez l'XPath du tableau dans XPath du tableau. Ce champ est obligatoire. Deux options contrôlent les lignes du fichier CSV :
Supprimer les lignes vides : supprime chaque ligne dont toutes les cellules sont vides. La ligne d'en-tête reste toujours, et une ligne qui contient au moins une valeur reste aussi. Cette option est activée par défaut.
Limite de lignes (optionnelle) : conserve uniquement les premières lignes du tableau, jusqu'au nombre que vous saisissez. La ligne d'en-tête n'est pas comptée. Thunders compte les lignes après avoir supprimé les lignes vides. Laissez le champ vide (Toutes les lignes) pour extraire toutes les lignes.
Avec une limite de lignes, Supprimer les colonnes vides vérifie uniquement les lignes conservées. Une colonne est supprimée uniquement quand son en-tête est vide et que toutes ses cellules sont vides dans ces lignes.
Nommer le fichier produit par une étape de capture
Screenshot (Viewport), Screenshot (Full Page), PDF Export (Chrome/Chromium only) et Extract File produisent chacune un fichier. Elles proposent deux options supplémentaires :
Nom du fichier (optionnel) : le nom du fichier produit. Thunders ajoute l'extension (
.png,.pdfou.csv). Vous pouvez utiliser des variables[VARIABLE], que Thunders remplace lors de l'exécution du test. Laissez le champ vide pour obtenir un nom généré.Ajouter aux fichiers de test : enregistre le fichier dans les fichiers de test du projet à chaque exécution. Le fichier remplace un fichier de test qui porte le même nom.
Sous ces options, l'étape affiche la variable qui contient le fichier. Utilisez cette variable dans les étapes suivantes, par exemple pour téléverser le fichier, pour vérifier son contenu, ou comme image de référence d'une étape de Comparaison Visuelle.
Nom du fichier | Ajouter aux fichiers de test | Variable |
Vide | Désactivé | La prochaine |
| Désactivé |
|
| Activé |
|
Un fichier de plus de 20 Mo n'est pas ajouté aux fichiers de test. L'étape s'exécute quand même, et le fichier reste dans les résultats de l'exécution.
Comment obtenir un sélecteur
Utilisation des outils de développement du navigateur
1. Utilisez cette méthode lorsque votre type de sélecteur est CSS ou XPath:
Cliquez avec le bouton droit sur l'élément et sélectionnez Inspecter.
Dans le panneau Éléments, cliquez avec le bouton droit sur le code HTML mis en surbrillance.
Sélectionnez Copier → Copier le sélecteur (CSS) ou Copier → Copier l'XPath complet.
Collez-le dans le champ Sélecteur de votre Étape web.
2. Si votre type de sélecteur est Étiquette ARIA ou Texte:
Étiquette ARIA : saisissez la valeur de l'attribut
aria-labelde l'élément (vous pouvez la vérifier dans le code HTML).Exemple : si l'élément contient
<button aria-label="Submit">, utilisezSubmit.
Texte : saisissez le texte visible qui apparaît à l'intérieur de l'élément.
Exemple : pour un bouton affichant « Connexion », utilisez
Connexion.
Conseils pour des sélecteurs fiables
Privilégiez les sélecteurs CSS plutôt que XPath lorsque cela est possible.
Ciblez des attributs stables (par exemple,
data-testid,aria-label, les noms de classes persistants).Évitez les identifiants dynamiques ou les chemins profondément imbriqués susceptibles de changer.
Assurez-vous que le sélecteur soit unique à un élément.



