Comment tester une application web avec Selenium et Cerberus Testing
Bienvenue dans ce tutoriel pas à pas Cerberus Testing consacré à l’automatisation des tests web. Ce guide vous aide à comprendre le processus d’automatisation des tests et les bonnes pratiques pour tester des applications web.
Étapes

Vous apprendrez à créer votre application sous test, puis à créer et exécuter des cas de test, et à en consulter les rapports. Le test que nous allons implémenter consiste à effectuer une recherche sur la page d’accueil de Google. À la fin de cet article, vous pourrez commencer à enrichir votre suite de tests automatisés et réaliser des tests multi-navigateurs (s’ouvre dans un nouvel onglet). Comme Cerberus Testing s’appuie sur Selenium WebDriver (s’ouvre dans un nouvel onglet), vous pouvez suivre ce tutoriel pour implémenter votre propre test. Si vous découvrez Cerberus Testing, nous vous conseillons de commencer par jeter un œil à notre page GitHub (s’ouvre dans un nouvel onglet), à notre site et à notre vidéo de présentation (s’ouvre dans un nouvel onglet).
Prérequis#
Pour mener à bien ce tutoriel, vous aurez besoin des éléments suivants :
- Une instance Cerberus Testing en version 4.10 minimum, auto-hébergée ou en SaaS.
- Un compte Cerberus Testing doté du rôle « Test ».
- Un environnement Cerberus Testing : « QA » et « UAT » sont configurés par défaut.
- Un Selenium Hub local ou distant, avec au moins un navigateur web disponible.
Si vous choisissez d’implémenter votre propre test, assurez-vous également des points suivants :
- L’accès à votre application sous test. Pour une application web, il s’agit généralement d’un accès réseau en HTTP ou HTTPS, et d’un compte utilisateur si une connexion est nécessaire.
- Les actions et contrôles de test que vous souhaitez réaliser, généralement enregistrés avec Selenium IDE (s’ouvre dans un nouvel onglet), sinon définis à partir des actions Selenium disponibles.
Pour toute question sur ces prérequis, consultez notre documentation (s’ouvre dans un nouvel onglet), nos vidéos (s’ouvre dans un nouvel onglet) ou contactez votre administrateur. N’hésitez pas à échanger avec la communauté sur notre canal Slack (s’ouvre dans un nouvel onglet) ou à ouvrir une issue GitHub (s’ouvre dans un nouvel onglet).
Étape 1 — Créer l’application web#
Dans cette partie, nous créons l’application Google avec sa définition et ses caractéristiques techniques. Nous créons d’abord l’application, puis nous lui ajoutons les environnements de test correspondants.
1.1 Créer l’application principale#
La première étape consiste à créer l’application que nous utiliserons ensuite dans notre cas de test. Nous pourrons ainsi réutiliser la même définition d’application dans plusieurs tests, ce qui simplifie leur maintenance. Il s’agit de définir le nom de l’application, sa description, sa typologie et les environnements disponibles.


La fenêtre suivante s’affiche, avec les informations nécessaires pour décrire votre application :
- Application : la clé de votre application ; nous recommandons d’utiliser son acronyme usuel. Saisissez « Google-Tutorial »
- Description : résumez ici votre application, dans notre cas « My Google Tutorial Application »
- System : sélectionnez le système lié à votre application ; ici, « EXAMPLES » convient.
- Type : sélectionnez « GUI – Web GUI application » pour que le test soit lancé comme un test web.
1.2 Ajouter les environnements correspondants#
Dernier élément de configuration : définir l’environnement de l’application, avec toutes les informations utiles pour atteindre votre application sous test. Vous pouvez aussi y définir d’autres environnements pour la même application, ce qui est utile lorsque vous voulez étendre votre suite de tests.
Un environnement se compose des trois éléments suivants :
- Environment : sélectionnez l’environnement de test, dans notre cas « UAT » (User Acceptance Testing, la recette utilisateur)
- Country : sélectionnez le contexte pays, choisissez « COM »
- Host : l’URL de l’application web, dans notre cas http://www.google.com
En dépliant le menu, vous pouvez aussi définir des paramètres avancés comme votre « Login URL », ce qui simplifiera ensuite vos actions de test.
Étape 2 — Créer le cas de test#
Nous allons maintenant construire le cas de test à exécuter sur l’application que nous venons de créer. De la même manière, nous ouvrirons le menu nécessaire, définirons le contenu du cas de test et partagerons quelques conseils sur la création des tests.
Cliquez sur « Create Test Case » pour afficher la fenêtre de création, que nous allons remplir avec les informations requises :
- Test Folder : choisissez le dossier dans lequel ranger vos cas de test ; ici, sélectionnez « Demo ». Les dossiers se gèrent depuis la page « Test / Test Folder ».
- Testcase ID : saisissez votre propre identifiant ou conservez celui généré par défaut.
- Test case short description : saisissez une description d’une ligne, généralement sous forme de cas d’usage : « En tant qu’internaute, je veux accéder à la page d’accueil de Google et rechercher une page »
- Application : l’application sous test, dans notre cas « Google-Tutorial »
- Status : l’état d’avancement de votre cas de test ; dans notre exemple, nous le passons à « IN PROGRESS ». À noter : le statut peut servir de critère pour l’exécution des tests, et un tableau de bord est disponible sur la page d’accueil.
- Type : sélectionnez « AUTOMATED » pour indiquer qu’il s’agit d’un test automatisé. Vous pouvez aussi avoir des tests manuels ou privés, que nous ne traiterons pas ici.
- Priority : généralement de 1 à 5, elle vous aide à prioriser l’implémentation de vos tests, votre reporting ou vos critères de go/no-go dans le rapport d’une campagne. Laissez-la à « 0 – No Priority defined ».
- Detailed description (optional) : utilisez ce champ pour saisir le cas d’usage et les informations de test utiles. Le format est en HTML, vous pouvez donc y copier du contenu enrichi. Nous y laissons un texte d’exemple.
Les autres onglets ne sont pas nécessaires pour l’instant. Une remarque si vous créez votre propre test et souhaitez l’exécuter dans l’environnement de test « PROD » : vous devrez l’activer dans l’onglet « Execution Settings » en cochant la case correspondante.
En cliquant sur « Create », vous confirmez la création du cas de test. Si vous acceptez la création par défaut, une étape (Step) par défaut est créée. Dans notre cas, nous partons d’une création entièrement nouvelle.
Étape 3 — Définir l’étape, les actions et les contrôles#
Nous pouvons maintenant configurer le contenu du cas de test grâce à la bibliothèque low-code : Step, Action et Control (étape, action et contrôle). Une étape regroupe les actions et les contrôles d’une phase principale de votre test. Bien conçus, ces éléments pourront être réutilisés d’un test à l’autre pour améliorer la maintenabilité de vos tests.
3.1 Ajouter l’étape du cas de test#
Ajoutez une étape avec le bouton « Add Step » et saisissez la description correspondante. Rédigez des descriptions claires : vos tests seront plus lisibles, plus faciles à maintenir et à réutiliser. Vous pouvez la nommer « Rechercher et vérifier une recherche Google ».


3.2 Ajouter les actions et contrôles du cas de test#
Dans cette étape, nous détaillons les différentes actions et les différents contrôles à réaliser pendant le test. Les commandes s’exécutent dans leur ordre d’apparition.


Voici les paramètres que vous pouvez utiliser :
- Accéder au site
- Action
openUrlLogin: ouvre l’URL de connexion renseignée dans la définition de l’application. - Notez que votre test web doit commencer par l’une des actions « open » pour que Cerberus Testing sache par où commencer.
- Action
- Saisir le terme recherché
- Action
type: saisit le texte voulu dans l’élément reconnu. - Chemin de l’élément
xpath=//input[@name='q'] - Texte à saisir
cerberus testing
- Action
- Cliquer sur le bouton de recherche
- Action
click: clique sur l’élément reconnu. - Chemin de l’élément
xpath=//input[@name='btnK']
- Action
- Faire une capture après la recherche
- Contrôle
takescreenshot: réalise une capture d’écran de la page web entière ; nous l’avons ajouté pour la démonstration. Les captures peuvent aussi être prises automatiquement à chaque action, ou seulement en cas d’erreur par exemple.
- Contrôle
- Vérifier les résultats de recherche
- Contrôle
verifyTextInPage: ici, nous vérifions que le lien http://vgeouyk.cluster030.hosting.ovh.net est présent dans la page. De nombreux autres contrôles sont disponibles et décrits dans la documentation.
- Contrôle
Nous validons les modifications en cliquant sur le bouton « Save Test Case » en haut à droite.
Étape 4 — Exécuter le cas de test#
Tout est prêt pour exécuter notre cas de test ! Rendez-vous sur la page d’exécution via « Run / Run Test Case ». Par défaut, les autres options restent indisponibles tant que le test n’a pas été exécuté une première fois dans un environnement donné.
4.1 Lancer le test depuis la page Run Test#
Le cas de test est sélectionné par défaut : il ne reste qu’à définir les paramètres d’exécution plus bas dans la page.

Vérifiez les paramètres suivants :
- Environment : sélectionnez un ou plusieurs environnements dans lesquels exécuter le cas de test. Dans notre cas, choisissez « UAT ».
- Country : cochez un ou plusieurs pays dans lesquels exécuter le cas de test. Là encore, le pays choisi doit être défini dans l’application. Choisissez « COM ».
- Robot Settings : définissez le hub de navigateurs sur lequel le cas de test sera exécuté. Les tests multi-navigateurs (s’ouvre dans un nouvel onglet) sont possibles si vous sélectionnez plusieurs navigateurs. Nous avons choisi « CerberusChrome », disponible nativement dans la version SaaS. Vous pouvez aussi vous connecter à des fermes de test distantes comme BrowserStack (s’ouvre dans un nouvel onglet) ou Saucelabs (s’ouvre dans un nouvel onglet), entre autres.
- Execution Settings : ces paramètres concernent surtout le niveau de traçabilité du test, l’infrastructure de test et les mécanismes de file d’attente (nouvelle tentative, priorité…). Dans notre cas, nous avons simplement renseigné le « Tag » avec tutorial-tag.
Lancez le cas de test et suivez son exécution en direct en cliquant sur « Run TestCase (and See Result) ».
4.2 Suivre l’exécution du cas de test#
La page d’exécution s’ouvre après le lancement du test.
Si vous rencontrez un problème à ce stade, voici les causes les plus fréquentes :
- Vérifiez la définition de votre application, en particulier l’environnement de test et le pays. Si un message mentionne ces paramètres, le problème vient probablement de là.
- Vérifiez les environnements activés pour votre cas de test. Si vous ne pouvez pas lancer votre test dans un environnement de production, vous devez l’activer explicitement dans l’en-tête du cas de test.
- Vérifiez que votre serveur Selenium fonctionne correctement et qu’il est joignable sur les ports configurés. Vous pouvez les gérer depuis la page « Run/Robots ».
Étape 5 — Analyser le rapport du cas de test#
Place à l’analyse du résultat de notre exécution ! Une fois le cas de test terminé, la barre de progression en haut de la page affiche le statut du test. Les principaux sont OK et KO ; vous trouverez plus de détails dans la documentation Cerberus Testing sur les statuts d’exécution (s’ouvre dans un nouvel onglet).


Voici les différents onglets et leur usage :
- Steps : l’historique de toutes les étapes, actions et contrôles réalisés par votre cas de test, avec les données utilisées et, par exemple, les liens vers les différentes captures d’écran.
- Properties : toutes les propriétés utilisées par votre test. Comme nous n’en avons défini aucune ici, cet onglet est vide.
- Execution Details : la traçabilité de l’exécution du cas de test, avec les heures de début et de fin, le statut et l’identifiant. C’est depuis cet onglet que vous pouvez ouvrir un ticket sur une plateforme externe, si elle est configurée.
- Environment : décrit le contexte d’environnement du cas de test.
- Robot : la traçabilité de votre infrastructure de test (robots) et des navigateurs.
- Traceability : les modifications éventuellement apportées à l’exécution.
Par exemple, le rapport indique le contexte du robot et ses paramètres, et donne accès aux différents logs.
Conclusion et prochaines étapes pour automatiser vos tests web#
Vous devriez maintenant avoir pu exécuter l’exemple décrit, voire un cas de test de votre choix. Nous espérons que ce tutoriel vous a aidé à comprendre les principales étapes de création d’un test pour une nouvelle application.
Vous pouvez désormais élargir votre couverture de test en créant des bibliothèques d’étapes réutilisables, en dupliquant ou en composant vos cas de test, et en les enrichissant de propriétés spécifiques. Une bonne pratique consiste à investir dans la conception de vos tests et de vos modules, pour obtenir des tests rapides, fiables et maintenables.
Pour passer à l’échelle, l’automatisation de vos tests pourra s’appuyer sur les autres fonctionnalités de Cerberus Testing : planification des tests, intégration CI/CD, gestion des tags, reporting et analytique.
Vous comparez les outils ? Notre comparatif vous aide à choisir une alternative open source à Selenium, et la page des fonctionnalités détaille tout ce que couvre Cerberus Testing en tests web.


