Passer au contenu principal

Comment ajouter et utiliser une étape web

Écrit par Ines

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

  1. Ouvrez votre scénario de test.

  2. Cliquez sur Ajouter une nouvelle étape.

  3. 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)

Une Étape web est ajoutée à un scénario de test : le type d'étape Étape web, une description, l'action Click, le type XPath et sa valeur. Puis le scénario de test s'exécute et ses 3 étapes réussissent.

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

goback

Accéder à la page précédente dans l'historique du navigateur.

Go Forward

goforward

Accéder à la page suivante dans l'historique du navigateur.

Reload

reload

Recharger la page actuelle.

Switch To Tab

switchtotab

Passer à un onglet déjà ouvert dans le navigateur. Nécessite une valeur (index d'onglet ou identifiant).

Open New Tab

opennewtab

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

wait

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

waitforselector

Attendre qu'un élément correspondant au sélecteur apparaisse dans le DOM. Nécessite un sélecteur.

Wait For Load State

waitforloadstate

Attendre que la page atteigne un état de chargement spécifique (par exemple, load, domcontentloaded, networkidle). Nécessite une valeur. Aucun sélecteur n'est nécessaire.

Wait For URL

waitforurl

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

click

Cliquez sur un élément. Nécessite un sélecteur.

Double Click

dblclick

Double-cliquez sur un élément. Nécessite un sélecteur.

Right Click

rightclick

Clic droit (menu contextuel) sur un élément. Nécessite un sélecteur.

Middle Click

middleclick

Clic central sur un élément (ouvre généralement le lien dans un nouvel onglet). Nécessite un sélecteur.

Click At

clickat

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

hover

Survolez un élément avec la souris. Nécessite un sélecteur.

Drag

drag_drop

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

input

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

clear

Efface le contenu d'un champ de saisie. Nécessite un sélecteur.

Press

press

Appuyer sur une touche ou une combinaison de touches du clavier (par exemple, Enter, Tab, Control+A). Nécessite une valeur (nom de la touche). Le sélecteur est facultatif (cible l'élément actif s'il est omis).

Select

select

Sélectionnez une option dans une liste déroulante <select>. Nécessite un sélecteur et une valeur (valeur de l'option ou libellé).

Open Dropdown

open_dropdown

Ouvrir un élément de menu déroulant sans sélectionner. Nécessite un sélecteur.

Check

check

Cochez une case à cocher ou un bouton radio. Nécessite un sélecteur.

Uncheck

uncheck

Désélectionner une case à cocher. Nécessite un sélecteur.

Select Text

selecttext

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

focus

Place le focus sur un élément. Nécessite un sélecteur.

Blur

blur

Retirer le focus d'un élément. Nécessite un sélecteur.

Scroll Into View

scroll

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)

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)

screenshot_full

Capture une capture d'écran de la page entière (y compris le contenu situé sous le pli). Aucun sélecteur requis.

PDF Export

pdf_export

Exportez la page actuelle au format PDF. Chrome/Chromium uniquement. Aucun sélecteur requis.

Extract File

extract_file_from_page

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, .pdf ou .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 [DOWNLOADED_FILE_N]

login-page

Désactivé

[DOWNLOADED_FILE_LOGIN_PAGE_PNG]

login-page

Activé

[FILE_LOGIN_PAGE_PNG]

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.

Dans les outils de développement du navigateur, un élément de la page est inspecté, puis copié depuis le menu Copy.
Un deuxième exemple : le même élément est inspecté, puis copié depuis le menu Copy.

2. Si votre type de sélecteur est Étiquette ARIA ou Texte:

  • Étiquette ARIA : saisissez la valeur de l'attribut aria-label de l'élément (vous pouvez la vérifier dans le code HTML).

    • Exemple : si l'élément contient <button aria-label="Submit">, utilisez Submit.

  • 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.

Autres articles connexes qui pourraient vous être utiles :

Avez-vous trouvé la réponse à votre question ?