Retour au Centre de connaissances
Démarrage

Attentes Selenium WebDriver pour des tests stables

Choisir les attentes Selenium selon des contrats observables du navigateur pour des tests autorisés lisibles et stables.

BotBrowser Team

Documentation

Vous voulez la documentation structurée pour Démarrage ?

Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.

Un test Selenium suit un contrat d’état, une attente explicite et une assertion visible

Résumé

  • Chaque attente nomme une frontière du navigateur et une conséquence : visibility_of_element_located indique si un élément est visible, element_to_be_clickable y ajoute l'état activé, et aucune des deux ne prouve qu'une mise à jour serveur est terminée.
  • Séparez sélecteur, état utilisable, clic et résultat en étapes distinctes pour que l'échec dise quel contrat manquait plutôt que seulement que le temps est écoulé.
  • Classez l'exception avant de toucher au délai : StaleElementReferenceException signifie que l'application a remplacé le nœud, ElementNotInteractableException concerne l'interactivité de la cible, un clic masqué peut provoquer ElementClickInterceptedException, et TimeoutException signifie que l'état attendu n'est jamais arrivé.
  • Notez la stratégie de chargement, car normal rend la main quand document.readyState vaut complete, eager dès que le DOM est interactif, et none sans rien attendre.
  • BotBrowser fournit un profil reproductible pour un parcours autorisé ; il ne remplace ni la politique d'attente, ni le contrat de disponibilité de l'application, ni le bloc finally qui appelle driver.quit().

Sommaire

Pourquoi une attente est un contrat

Pour situer ces attentes dans une migration de framework, les changements pratiques d'une alternative à Selenium relient protocole, propriété du navigateur et preuves d'échec.

Dans une collecte de données, une attente établit uniquement que la page est prête ; le flux de collecte avec Selenium consigne séparément les capacités de session et valide les lignes obtenues selon un schéma.

Une pause mesure seulement le temps écoulé. Une bonne attente nomme l’état observable et le résultat si cet état n’arrive pas. Le diagnostic distingue ainsi lenteur et absence de préparation. BotBrowser peut donner à un environnement de test contrôlé un profil cohérent pour s'exécuter ; il ne peut pas corriger une attente mal choisie ni changer le comportement de WebDriver ou d'une page.

Navigation, activation d’un bouton, arrivée de données, nouvelle fenêtre et cadre dynamique sont des frontières différentes. Chacune mérite son observation et sa limite. Pour une observation fondée sur les événements, voir événements WebDriver BiDi pour une automatisation stable.

Commencez par le résultat visible, comme un titre de confirmation ou une région de statut. La documentation Selenium WebDriver décrit le protocole; l’application définit son contrat.

Relier chaque attente à sa frontière

Une condition explicite doit avoir une responsabilité. La visibilité ne prouve pas que la mise à jour distante est terminée, et le clic possible ne prouve pas que le résultat est rendu.

Préférez une propriété stable et documentée à une classe d’animation. Un attribut de disponibilité soutenu par l’application est une meilleure signalisation.

La guide des attentes Selenium distingue attentes implicites, explicites et fluides. Gardez la politique implicite simple.

Des sélecteurs qui expriment l’état

Un sélecteur fondé sur un libellé, un rôle accessible ou un identifiant stable explique l’intention. Une classe générée ou une position peut changer sans changer la fonction. Les rôles et noms accessibles servent aussi aux contrôles d’accessibilité, comme décrit dans tests d’accessibilité de l’automatisation du navigateur.

Séparez recherche et assertion: trouvez le contrôle, attendez son état actif, agissez une fois, puis attendez le résultat. Les chemins négatifs attendent leur message prévu.

Nommez les aides selon le contrat, par exemple attendre_confirmation_commande. Gardez l’assertion sur la surface sémantique visible. Pour les transferts de fichiers, voir fiabiliser les tests de transfert de fichiers dans le navigateur.

Une URL atteinte ne prouve pas que la vue principale est prête. Attendez un repère visible puis vérifiez le résultat de l’application.

Après une ouverture, attendez le nouvel identifiant de fenêtre, changez de contexte et attendez son repère. Pour un cadre dynamique, entrez puis revenez explicitement. Si le rendu remplace un hôte shadow, retrouvez l'hôte, la racine et l'enfant comme dans le diagnostic Shadow DOM avec Selenium, en gardant l'action hors de la condition d'attente.

Une fenêtre bloquée ou une redirection est une catégorie de résultat. Ne rejouez pas automatiquement une action qui a peut-être réussi.

Remplacer les suppositions par des preuves

Le diagnostic de element not interactable par commande reproduit une cible cachée et la distingue d'un clic intercepté et d'un champ en lecture seule. Identifiez la commande en échec avant de choisir une condition d'attente.

Un délai expiré doit nommer la condition absente, le sélecteur, l’URL, les versions et la tentative. Les captures suivent les règles de confidentialité.

Classez élément obsolète, élément non interactif et délai expiré avant d’augmenter une limite. Selenium montre l’observation, pas la cause serveur.

Utilisez un sondage borné. Si la page ralentit, vérifiez d’abord que le signal représente encore l’expérience visible.

Propriété des profils et pilotes

Pilote, navigateur, profil et fixture forment une unité. Enregistrez-les, donnez un dossier à chaque session et fermez le pilote normalement.

BotBrowser prend en charge la compatibilité ChromeDriver et Selenium Grid pour des flux autorisés. Cela ne garantit pas chaque version ni ne remplace la politique d’attente. Voir la guide des profils Selenium et la validation des interactions.

Entre machines, comparez un résultat convenu plutôt que des durées identiques, et le relevé de divergence entre nœuds Grid sépare un écart de timing d’un écart de valeurs avant de traiter l’un ou l’autre comme une cause. Système, pilote, graphismes et réseau changent les délais.

Des tests maintenables

Un parcours forme une chaîne: état synthétique, contrôle visible, état opérable, action unique et résultat suivant. Nommez chaque frontière.

Révisez les attentes lors d’un changement d’interface. Mettez à jour sélecteur, prédicat, assertion et message ensemble, y compris les refus.

Avant intégration, utilisez un profil propre et les versions enregistrées. Vérifiez la fermeture dans les deux chemins et des artefacts synthétiques.

Une table d’états, écrite dans la conception du test, rend cette chaine vérifiable. Pour un parcours de connexion elle tient en ces quelques lignes :

ÉtapeSe termine quandPreuve en cas d’échec
ouvrir le formulairepresence_of_element_located sur le champ courrielfragment du code de la page
soumettreelement_to_be_clickable sur le bouton d'envoiURL courante et capture d'ecran
résultatvisibility_of_element_located sur le titre du compte ou la zone de refusle localisateur absent et son état
fermer la sessiondriver.quit() revient sans lever d'exceptionl'identifiant de session restant

La table n'est pas une seconde implémentation du test. C'est un accord compact entre le responsable de la page et celui du test sur ce qui est observable et sur qui diagnostique un écart.

La disparition d’un indicateur n’est fiable que si elle garantit le contrôle suivant. Le sondage doit rester sans effet secondaire. Avec Playwright, vérifier séparément la réponse et la révision affichée permet de savoir lequel de ces deux signaux manque.

Des budgets séparés rendent visibles les frontières lentes. Une nouvelle tentative autorisée crée une session propre et est marquée.

Répétez le chemin d’échec avec un fixture qui retient un signal. Un délai borné et précis vaut mieux qu’un test vert incomplet.

BotBrowser prend en charge ChromeDriver et Selenium Grid pour les flux autorisés, mais ne garantit pas chaque version et ne remplace ni la politique d’attente ni le nettoyage du profil.

Le registre de revue conserve contrat, budget, propriétaire et preuve afin que chaque changement d’interface ait un responsable clair.

Sources

Conclusion pratique

Livrez le tableau des états avec le test : une ligne par étape, le prédicat qui la termine et l'artefact recueilli en cas d'échec. Gardez les budgets visibles et séparés, afin qu'une attente de deux secondes sur un sélecteur, une de quinze secondes sur le rendu et une de trente sur le relais distant ne se fondent jamais dans un nombre global. Répétez le chemin d'échec avec une fixture qui retient un signal de disponibilité et vérifiez que le délai nomme ce signal au lieu de rester bloqué. Quand l'interface change, mettez à jour sélecteur, prédicat, assertion et message d'échec dans la même modification.

#Selenium#WebDriver#Attentes Explicites#Stabilité Des Tests

Cet article fait partie du guide : Débuter avec l'automatisation du navigateur : carte initiale

Exécutez la même vérification dans BotBrowser

Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.