Explorer WebUiCommonHelper dans Katalon Studio / Blogs / Perficient

Katalon Studio est un outil populaire pour l’automatisation des tests Web, offrant diverses fonctionnalités pour simplifier les processus de test. Parmi ceux-ci, la classe WebUiCommonHelper se démarque comme un composant crucial. Il fournit une gamme de méthodes utilitaires conçues pour rendre les interactions avec les éléments Web plus efficaces et améliorer la fonctionnalité globale de vos scripts de test. Ce blog explorera les fonctionnalités de WebUiCommonHelper, ses scénarios d’utilisation courants et les avantages qu’il apporte à vos projets d’automatisation.

Qu’est-ce que WebUiCommonHelper ?

WebUiCommonHelper est une classe d’assistance de Katalon Studio qui étend les capacités des mots-clés intégrés de la plateforme. Il fonctionne en étroite collaboration avec Selenium WebDriver pour fournir des méthodes supplémentaires facilitant la localisation, la manipulation et la gestion des éléments Web. Cette classe est particulièrement utile pour gérer des scénarios complexes qui pourraient s’avérer difficiles avec les seuls mots-clés standards.

Méthodes clés dans WebUiCommonHelper

Voici quelques-unes des méthodes les plus importantes fournies par WebUiCommonHelper :

• findWebElement (TestObject testObject, int timeout)
  • Cette méthode vous aide à localiser un élément Web basé sur un TestObject. Si le TestObject a déjà un WebElement mis en cache, il le renvoie ; sinon, il recherche la page Web en utilisant les propriétés de TestObject.
  • Exemple:

WebElement element = WebUiCommonHelper.findWebElement(findTestObject('Page_Example/button_Submit'), 30);

• findWebElements (TestObject testObject, int timeout)
  • Semblable à findWebElement, mais au lieu d’un seul élément, cette méthode renvoie une liste de tous les éléments Web qui correspondent au TestObject spécifié.
  • Exemple:

List<WebElement> elements = WebUiCommonHelper.findWebElements(findTestObject('Page_Example/items_List'), 30);

• buildLocator (TestObject testObject)
  • Cette méthode crée un localisateur basé sur les propriétés du TestObject. Vous pouvez utiliser ce localisateur pour rechercher manuellement des éléments sur la page Web.
  • Exemple:

String locator = WebUiCommonHelper.buildLocator(findTestObject('Page_Example/input_Search'));

• switchToParentFrame (TestObject testObject)
  • Cette méthode est utile lorsqu’il s’agit de cadres imbriqués dans des applications Web. Il vous permet de basculer le contexte vers le cadre parent d’un TestObject spécifié.
  • Exemple:

WebUiCommonHelper.switchToParentFrame(findTestObject('Page_Example/iframe_Content'));

• closeWindowUsingTitle (WebDriver webDriver, titre de chaîne)
  • Si vous devez fermer une fenêtre de navigateur en fonction de son titre, cette méthode facilite la tâche. Il trouve la fenêtre portant le titre spécifié et la ferme.
  • Exemple:

WebUiCommonHelper.closeWindowUsingTitle(WebDriverInstance, "Example - Title");

Scénarios d’utilisation courants

WebUiCommonHelper est souvent utilisé avec d’autres mots-clés de Katalon Studio pour créer des scripts de test plus efficaces. Voici quelques scénarios où cela brille :

• Gestion des éléments dynamiques
  • Dans les applications Web au contenu dynamique, les éléments peuvent ne pas toujours être immédiatement disponibles ou changer fréquemment. En utilisant findWebElement avec un délai d’attente personnalisé, vous pouvez vous assurer que votre script attend que l’élément apparaisse, réduisant ainsi les risques d’échec de vos tests en raison de problèmes de timing.
  • Exemple:

WebElement element = WebUiCommonHelper.findWebElement(findTestObject('Page_Example/button_Submit'), 30);

element.click();

• Interactions complexes
  • Lorsque vous traitez des interactions utilisateur complexes, telles que des opérations de glisser-déposer personnalisées ou l’interaction avec des éléments non standard, WebUiCommonHelper vous permet d’injecter un script ou d’effectuer des actions qui pourraient ne pas être prises en charge par les mots-clés standard de l’interface utilisateur Web de Katalon.
  • Exemple:

WebUiCommonHelper.executeScript("arguments[0].click();", Arrays.asList(element));

WebUiCommonHelper contre findTestObject

Comprendre la différence entre WebUiCommonHelper et findTestObject est essentiel pour les utiliser efficacement :

• WebUiCommonHelper :
  • Fournit des méthodes utilitaires pour travailler directement avec des objets WebElement à l’aide de Selenium WebDriver.
  • Des méthodes telles que findWebElement() et switchToParentFrame() simplifient les interactions entre les éléments et étendent les fonctionnalités.
  • Renvoie les objets WebElement.
• findTestObject :
  • Récupère un TestObject du référentiel d’objets, qui représente un élément d’interface utilisateur dans l’application.
  • Généralement utilisé en conjonction avec les mots-clés intégrés de l’interface utilisateur Web de Katalon.
  • Renvoie les instances TestObject.

Avantages de l’utilisation de WebUiCommonHelper

L’utilisation de WebUiCommonHelper dans Katalon Studio offre plusieurs avantages :

1. Interactions d’éléments simplifiées :
   • Des méthodes telles que findWebElement() facilitent la localisation et l’interaction avec les éléments, réduisant ainsi la complexité du travail direct avec Selenium WebDriver.
2. Fonctionnalité améliorée :
   • Il étend les capacités des mots-clés intégrés de Katalon, vous permettant d’effectuer des tâches telles que changer d’image et prendre des captures d’écran plus efficacement.
3. Fiabilité des tests améliorée :
   • En gérant plus gracieusement les éléments dynamiques et les interactions complexes, WebUiCommonHelper contribue à rendre vos tests plus fiables et moins sujets aux échecs.

WebUiCommonHelper est un outil essentiel de Katalon Studio pour tous ceux qui cherchent à améliorer leurs scripts d’automatisation Web. Que vous ayez affaire à du contenu dynamique, à des interactions utilisateur complexes ou que vous souhaitiez simplement simplifier vos scripts de test, cette classe d’assistance fournit les fonctionnalités dont vous avez besoin. En maîtrisant WebUiCommonHelper, vous pouvez créer des tests automatisés plus robustes, flexibles et fiables, rendant vos efforts d’automatisation Web plus efficaces.