Options avancées pour les étapes des tests Browser

Localisateur spécifié par l’utilisateur

Par défaut, les tests Browser ont recours au système de localisation de Datadog. Nous vous conseillons d’utiliser uniquement des localisateurs personnalisés en cas de nécessité absolue. En effet, le système de localisation de Datadog permet aux tests de s’adapter automatiquement en cas de changement.

Pour créer un localisateur personnalisé, effectuez une action pertinente sur un élément de votre page dans la zone d’enregistrement (cliquer, survoler, exécuter une assertion, etc.). Cette action définit l’étape à suivre.

Pour spécifier votre localisateur personnalisé :

  • Enregistrez ou ajoutez manuellement une étape à votre enregistrement.
  • Cliquez sur l’étape enregistrée, puis sur Advanced options.
  • L’élément HTML peut ensuite être sélectionné à l’aide d’un X-path ou une classe/un ID CSS, comme div, h1 ou .hero-body.
  • Après avoir défini l’élément, cliquez sur Test pour le mettre en évidence dans l’enregistrement à droite.

Par défaut, la case If user specified locator fails, fail test est cochée. Cela signifie qu’en cas d’échec du localisateur, le test échoue.

Vous pouvez choisir d’appliquer un algorithme de test Browser standard en décochant cette case.

Option d'échec du test

Délai d’expiration

Lorsqu’un test Browser ne parvient pas à localiser un élément, par défaut, il continue d’exécuter l’étape pendant 60 secondes.

Vous pouvez choisir d’augmenter ou de réduire cette durée (max : 300 secondes) si vous souhaitez prolonger ou limiter la période de recherche de l’élément cible de l’étape.

Délai avant échec

Étape facultative

Dans certaines situations, par exemple lorsqu’une fenêtre contextuelle s’affiche, vous pouvez faire en sorte que certaines étapes soient facultatives. Pour ce faire, cochez la case Allow this step to fail. Si l’étape échoue après le délai d’expiration indiqué (par défaut, 60 secondes), le test se poursuit et passe à la prochaine étape.

Allow this step to fail

Empêcher les captures d’écran

Vous pouvez éviter d’enregistrer une étape de capture d’écran lors de l’exécution d’un test. Cela peut s’avérer utile pour s’assurer qu’aucune donnée sensible ne figure dans les résultats du test. Utilisez cette option avec précaution, car elle peut rendre plus difficile le dépannage des problèmes. Pour en savoir plus sur les recommandations de sécurité, consultez cette page.

Option d'enregistrement de capture d'écran

Remarque : cette fonctionnalité peut également être appliquée à l’ensemble d’un test Browser. Il s’agit d’une option avancée de la configuration du test.

Sous-tests

Les options avancées des sous-tests vous permettent également de définir l’endroit où le sous-test doit être exécuté :

  • Main (valeur par défaut) : le sous-test s’exécute dans votre fenêtre principale, à la suite des autres étapes.
  • New : le sous-test s’exécute dans une nouvelle fenêtre, qui se ferme à la fin du sous-test. La fenêtre ne peut donc pas être réutilisée.
  • Specific window : le sous-test s’exécute dans une fenêtre numérotée, qui peut être réutilisée par d’autres sous-tests.
Sous-tests

En ouvrant votre sous-test dans la fenêtre principale, celui-ci s’exécute à la suite de votre test principal. Il utilise ainsi l’URL de l’étape précédente. À l’inverse, si vous ouvrez votre sous-test dans une nouvelle fenêtre ou dans une fenêtre spécifique, le test s’exécute sur l’URL de départ du sous-test.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: