Déballage des paramètres de TestNG et des Annotations de fournisseur de données

Contrairement à l’ancien framework de test JUnit fiable &, TestNG est l’outil d’automatisation de test moderne. Il prend en charge les tests pilotés par les données et fournit deux façons de fournir des données aux cas de test, c’est-à-dire via des paramètres de test et des annotations de fournisseur de données.

Avec l’ajout de ces deux annotations, le framework TestNG a comblé une lacune importante que son prédécesseur avait. L’une de ces annotations ajoute la possibilité d’utiliser des valeurs de données fixes dans les cas de test, tandis que l’autre permet d’interroger des valeurs à partir de sources de données externes telles qu’Excel ou les fichiers de propriétés.

Dans les sections suivantes, vous verrez l’utilisation en direct des paramètres de TestNG et des annotations de fournisseur de données avec des exemples prêts à l’exécution.

Paramètres de test et Annotations de fournisseur de données

Avantages des tests paramétriques

Avant de continuer, comprenons les avantages des tests paramétriques / pilotés par les données. Tout outil d’automatisation des tests qui possède ces deux capacités peut prendre en charge efficacement les cas suivants.

• Traitez le grand ensemble de données selon les besoins de l’entreprise.
• Exécutez le même test encore et encore avec des valeurs différentes.

Voyons maintenant quand et comment utiliser l’annotation <@Parameters > dans les projets de test.

Annotation @Parameters

À l’aide de cette annotation, vous pouvez autoriser des valeurs de paramètres uniques et multiples aux méthodes de test.

Nous pouvons l’utiliser pour les tests de paramètres. Il est conseillé lorsque les données sont petites et fixes pour les cas de test.

Exemple – Annotation @Parameters

Suivez les étapes ci-dessous pour utiliser l’annotation <@Parameters>.

Étape 1

Créez une nouvelle classe Java et nommez-la comme <ParametersTesting.Java >. Ajoutez les deux méthodes suivantes dans la classe.

i-OpenBrowser()

• Cela prendra un seul paramètre de type de chaîne, c’est-à-dire browserName.
• Ajoutez l’annotation @Parameters (« BrowserName ») à cette méthode.

ii-FillLoginForm()

Étape 2

Voici le TestNG.Fichier XML avec les paramètres associés aux méthodes de test.

Il est maintenant temps d’exécuter le test <.Fichier XML >. Cliquez avec le bouton droit sur le fichier XML de l’EDI Eclipse et appuyez sur l’option « Exécuter en tant que >>TestNG Suite ». Après l’exécution, la sortie sera affichée comme celle donnée dans la capture d’écran ci-dessous.

Un autre fait intéressant à propos du TestNG est qu’il permet de passer des paramètres optionnels à l’aide de l’annotation @Optional.

@Annotation optionnelle

Vous pouvez l’utiliser pour spécifier une valeur optionnelle pour un paramètre qui n’est pas disponible dans le TestNG.Fichier XML.

Exemple – @Annotation optionnelle

Référez-vous à l’exemple d’annotation @Optionnelle ci-dessous.

TestNG XML

Voici le « TestNG.XML  » associé à l’exemple ci »dessus.

Vous pouvez vérifier à partir du test ci-dessus <.fichier xml > dans lequel deux méthodes de test sont définies. Le premier test n’a aucun paramètre tandis que le second spécifie un paramètre nommé « valeur facultative. »

Sortie :

Après avoir exécuté le test <.xml > en tant que suite de tests, la sortie serait la suivante.

Si vous observez les résultats du test, TestNG a utilisé la valeur facultative lors de l’exécution de la première méthode de test. C’est arrivé parce que TestNG n’a pas pu trouver un paramètre nommé « valeur facultative » dans le fichier XML pour le premier test. Cependant, pour le deuxième test, il a résolu la valeur du paramètre qui est également imprimée lors de l’exécution du test.

Pour votre note, vous pouvez utiliser l’annotation de paramètre avec l’une des méthodes annotées Avant/après, Usine et Test. De plus, vous pouvez l’utiliser pour définir des variables et les utiliser dans class, test ou suite de tests.

Annotation @DataProvider

Le fournisseur de données est une autre annotation qui prend en charge les tests pilotés par les données. Vous pouvez l’utiliser pour gérer un large éventail de paramètres complexes tels que les suivants.

• Objets Java
• Objets d’une base de données
• Données d’Excel ou de fichiers de propriétés

Faits sur l’annotation @DataProvider

Voici quelques faits intéressants sur le fournisseur de données.

• Cette annotation a un attribut de chaîne qui est son nom. Si vous ne spécifiez pas de nom, le nom de la méthode sert de nom par défaut.
• Une méthode de fournisseur de données prépare et renvoie une liste 2d d’objets.
• Un test piloté par les données s’exécuterait une fois pour chaque ensemble de données spécifié par l’objet fournisseur de données.

Comment utiliser l’annotation @DataProvider

Voyons maintenant les étapes requises pour utiliser l’annotation du fournisseur de données pour les tests pilotés par les données.

• Créez une nouvelle classe Java, par exemple, le DataProviderTest.Java.
• Définissez la méthode du fournisseur de données annotée à l’aide du <@DataProvider >. Il doit renvoyer la liste 2d des objets.
• Ajoutez une méthode de test et décorez-la en utilisant le <@Test(dataProvider= »nom du fournisseur de données »)>.

Pour plus de clarté sur l’annotation du fournisseur de données, lisez très attentivement l’exemple de code ci-dessous. Dans cet exemple de code, nous démontrons les trois utilisations différentes des fournisseurs de données.

• Passage d’un objet entier Java à l’aide du fournisseur de données
• Diffusion d’un objet bean Java à l’aide du fournisseur de données

Exemple Utilisant l’annotation @DataProvider

Fichier XML de test

Vous pouvez exécuter le code ci-dessus à partir d’Eclipse en tant que Test de test. Ou vous pouvez générer le test <.XML >, puis exécutez le fichier XML en tant que suite de tests.

Sortie:

Après avoir exécuté le code ci-dessus en tant que test ou en tant que suite de tests, vous verrez la sortie suivante. Veuillez vérifier à partir de l’extrait ci-dessous.

Final Word – Paramètres de test et fournisseur de données

Nous avons essayé de couvrir autant que possible les Paramètres de test et les annotations de fournisseur de données ainsi que leurs exemples. Cependant, il existe de nombreux autres cas d’utilisation des fournisseurs de données que nous aborderions dans un article séparé. D’ici là, profitez de la lecture de ce post et partagez-le sur les réseaux sociaux.

Tous les meilleurs,

TechBeamers