TestNG Tutoriel

Qu'est-ce que le TestNG?

TestNG est un framework de tests d'automatisation où « NG » signifie « Next Generation ». TestNG est inspiré par JUnit et utilise Java Les annotations (@) permettent de contrôler le flux des tests. Cela permet de surmonter JUnitLes limitations antérieures de et est conçu pour rendre tests de bout en bout Plus facile.

Avec TestNG Vous pouvez générer un rapport détaillé et voir immédiatement le nombre de tests réussis, échoués ou ignorés. Vous pouvez également relancer uniquement les tests ayant échoué.

Par exemple :

• Supposons que vous ayez cinq cas de test, chacun dans sa propre méthode, écrits sans TestNGTrois tests réussissent ; le quatrième échoue. Après avoir corrigé le quatrième, vous souhaitez relancer uniquement celui-ci, puisque les trois premiers ont déjà réussi. Ceci est difficile à réaliser avec une simple fonction main().
• TestNG fournit une testng-failed.xml déposer dans le test-output dossier. L'exécution de ce fichier XML ne réexécute que les cas ayant échoué.

De plus, vous découvrirez les avantages de TestNG, comment écrire des méthodes de test avec des annotations @Test, et comment convertir vos classes en une suite de tests exécutable à partir de Eclipse ou la ligne de commande.

Pourquoi utiliser TestNG au Selenium?

Par défaut, Selenium Les tests ne produisent pas de résultats bien formatés. TestNG Une fois connecté, l'outil de test génère un rapport structuré que vous pouvez partager avec l'équipe.

pont Selenium les utilisateurs préfèrent TestNG plus de JUnit en raison de son ensemble de fonctionnalités plus étendu. Les principales caractéristiques pour Selenium sont:

• Des rapports indiquant le nombre de cas de test exécutés, réussis, échoués et ignorés.
• Groupe facileping de cas de test via un testng.xml fichier, avec priorités d'exécution.
• Répéter un test plusieurs fois sans boucles en utilisant invocationCount.
• Exécuter plusieurs tests sur plusieurs navigateurs — cross-test du navigateur soutien.
• Intégration fluide avec Maven, Jenkinset d'autres outils d'intégration continue.
• Readable annotations — par exemple, @BeforeMethod, @AfterMethod, @BeforeTest, @AfterTest.
• Selenium WebDriver ne dispose d'aucune fonctionnalité de reporting native ; TestNG comble cette lacune avec un rapport HTML clair comme celui ci-dessous.

• TestNG Cela simplifie le code de test. Plus besoin de méthode main statique ; les annotations déterminent ce qui s’exécute et quand.

• Les exceptions non interceptées sont gérées avec élégance par TestNGCes étapes sont signalées comme ayant échoué sans pour autant interrompre l'exécution complète.

Avantages de TestNG plus de JUnit

TestNG offre trois avantages majeurs par rapport à JUnit:

• Les annotations sont plus faciles à comprendre et à utiliser.
• Les cas de test peuvent être regroupés et priorisés avec moins d'efforts.
• L'exécution parallèle des tests est prise en charge nativement.

Qu'est-ce qu'une annotation dans TestNG?

Annotations dans TestNG Ce sont des lignes de code placées au-dessus d'une méthode pour contrôler son exécution. Elles commencent toujours par le symbole @. Un exemple simple est présenté ci-dessous.

Les annotations sont traitées en détail dans la section « Annotations utilisées dans TestNG » Plus tard dans ce tutoriel, nous aborderons ce sujet plus en détail ; l'exemple ci-dessus sert donc uniquement à définir les attentes. TestNG Les annotations sont plus faciles à coder et à lire que les JUnit équivalents, et ils sont essentiels lors de l'exécution de tests sur Selenium Grille là où l'exécution parallèle est importante.

Comment rédiger des cas de test dans TestNG

Rédaction d'un TestNG Le cas de test comporte trois étapes :

1. Rédigez votre logique métier et placez-la TestNG annotations au-dessus de chaque méthode.
2. Ajoutez des métadonnées telles que le nom de la classe, le nom du groupe et le nom du package.
3. Exécutez le TestNG classe depuis votre IDE ou la ligne de commande.

Créer un cas de test en utilisant TestNG Annotations

Nous allons maintenant créer notre premier cas de test en utilisant TestNG annotations dans SeleniumAvant de rédiger le test, configurez un nouveau TestNG projet en Eclipse et appelez-le PrénomTestNGProjet.

Création d'un nouveau TestNG Projet

Étape 1) Cliquez à nouveau Fichier > Nouveau > Java Projet.

Étape 2) Entrer PrénomTestNGProjet comme nom de projet et cliquez Suivant.

Étape 3) Importer le TestNG bibliothèques. Cliquez sur Bibliothèques onglet, puis Ajouter une bibliothèque….

Étape 4) Dans l' Ajouter une bibliothèque dialogue, choisissez TestNG et cliquez sur Suivant.

Étape 5) Cliquez à nouveau Finition.

TestNG devrait maintenant apparaître dans la liste des bibliothèques.

Étape 6) Ajoutez les fichiers JAR qui contiennent les Selenium Ces données proviennent de l'API. Java pilote client téléchargé depuis selenium.dev/téléchargements.

Accédez au dossier où se trouve le Selenium Les fichiers JAR sont stockés.

Après avoir ajouté les fichiers JAR externes, l'écran devrait ressembler à ceci.

Étape 7) Cliquez à nouveau Finition. La nouvelle PrénomTestNGProjet apparaît dans l'explorateur de paquets.

Comment créer un nouveau TestNG Fichier d'essai

Une fois le projet prêt, créez un nouveau TestNG fichier.

Étape 1) Faites un clic droit sur le src dossier et choisissez Nouveau > Autres….

Étape 2) Élargir la TestNG dossier, sélectionnez TestNG classeEt cliquez Suivant.

Étape 3) Saisissez les valeurs indiquées ci-dessous et cliquez FinitionL’ Java le fichier est nommé PrénomTestNGFichier.

Étape 4) Eclipse génère le TestNG Modèle présenté ci-dessous.

Programmer votre premier TestNG Cas de test

Créez le premier cas de test qui vérifie le titre du Mercury Page d'accueil des visites.

package firsttestngpackage;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.Test;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;

    @Test
    public void verifyHomepageTitle() {
        System.out.println("launching firefox browser");
        // Selenium 4 ships Selenium Manager, so the driver path is no longer required.
        driver = new FirefoxDriver();
        driver.get(baseUrl);
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
        driver.quit();
    }
}

A noter :

• TestNG n'a pas besoin d'un main() méthode.
• Les méthodes n'ont pas besoin d'être statiques.
• Le @Tester marques d'annotation verifyHomepageTitle() comme cas test.
• Les annotations résident dans le org.testng.annotations.* paquet.
• Le Affirmer classe de org.testng.Assert vérifications des pilotes.

Vous pouvez avoir plusieurs annotations @Test dans un seul TestNG Nous abordons ce sujet dans le dossier. « Annotations utilisées dans TestNG » .

Exécution du test

Faites un clic droit sur le fichier et exécutez-le en tant que TestNG test. Eclipse produit deux résultats : un résultat textuel dans la fenêtre Console et un résultat graphique dans la TestNG Fenêtre de résultats.

Vérification des rapports créés par TestNG

La fenêtre Console fournit un résumé textuel tandis que TestNG La fenêtre de résultats affiche une vue graphique.

Génération de rapports HTML

TestNG peut également générer des rapports HTML complets.

Étape 1) Après avoir couru PrénomTestNGFichier, cliquez avec le bouton droit sur le projet et choisissez Refresh.

Étape 2) A sortie de test Le dossier apparaît. Développez-le et localisez index.html — le rapport HTML de la dernière exécution.

Étape 3) Double-Cliquez sur index.html pour l'ouvrir à l'intérieur EclipseNavigateur de . Appuyez sur F5 pour actualiser après les prochaines exécutions.

Annotations utilisées dans TestNG

Vous avez déjà vu l'annotation @Test. La suite de cette section présente les annotations avancées les plus utiles.

Plusieurs cas de test

Un célibataire ou Individual TestNG Un fichier peut contenir plusieurs annotations @Test. Par défaut, les méthodes annotées avec @Test s'exécutent par ordre alphabétique. Dans le code ci-dessous, les méthodes c_test, a_test et b_test exécuter par ordre alphabétique, indépendamment de l'ordre des sources.

Exécutez le code et ouvrez index.html. Cliquez sur Vue chronologique.

Paramètres

Pour modifier l'ordre par défaut, utilisez priority paramètre. Les paramètres sont des mots-clés qui modifient le comportement d'une annotation.

• Attribuer une valeur avec =.
• Encadrez les paramètres par des parenthèses placées immédiatement après l'annotation, comme indiqué ci-dessous.

TestNG Exécute les annotations @Test de la priorité la plus basse à la plus élevée. Les numéros de priorité ne doivent pas nécessairement être consécutifs.

Le rapport HTML confirme que les méthodes ont été exécutées par ordre de priorité croissant.

Paramètres multiples

En outre priority, @Test accepte le alwaysRun paramètre (vrai ou faux). Pour utiliser deux paramètres ou plus dans une seule annotation, séparez-les par une virgule :

@Test(priority = 0, alwaysRun = true)

@BeforeTest et @AfterTest

@AvantTest	Les méthodes annotées s'exécutent avant le premier cas test dans le TestNG filet.
@AprèsTest	Les méthodes annotées s'exécutent après tous les cas de test dans le TestNG finition du fichier.

Considérez le code ci-dessous.

package firsttestngpackage;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.*;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;

    @BeforeTest
    public void launchBrowser() {
        System.out.println("launching firefox browser");
        driver = new FirefoxDriver();
        driver.get(baseUrl);
    }

    @Test
    public void verifyHomepageTitle() {
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
    }

    @AfterTest
    public void terminateBrowser() {
        driver.quit();
    }
}

D'après le tableau et le code, nous pouvons prédire que la séquence sera :

• 1er — launchBrowser()
• 2e — verifyHomepageTitle()
• 3e — terminateBrowser()

Le placement des blocs d'annotation dans le fichier source n'affecte pas leur ordre d'exécution. Essayez de réorganiser les méthodes comme indiqué ci-dessous.

package firsttestngpackage;

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.*;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;

    @AfterTest                              // Jumbled
    public void terminateBrowser() {
        driver.quit();
    }

    @BeforeTest                             // Jumbled
    public void launchBrowser() {
        System.out.println("launching firefox browser");
        driver = new FirefoxDriver();
        driver.get(baseUrl);
    }

    @Test                                   // Jumbled
    public void verifyHomepageTitle() {
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
    }
}

Exécutez le code et vérifiez le résultat.

@BeforeMethod et @AfterMethod

@AvantMéthode	Les méthodes annotées s'exécutent avant chaque méthode de test.
@AprèsMéthode	Les méthodes annotées s'exécutent après chaque méthode de test.

In Mercury Prenons l'exemple de visites virtuelles : supposons que nous voulions vérifier les titres de deux pages cibles accessibles depuis la page d'accueil.

Le déroulement du test est le suivant :

• Ouvrez la page d'accueil et vérifiez son titre.
• Cliquez sur S'INSCRIRE et vérifiez le titre de sa page cible.
• Retournez à la page d'accueil et vérifiez le titre.
• Cliquez sur SUPPORT et vérifiez le titre de sa page cible.
• Retournez à la page d'accueil et vérifiez à nouveau le titre.

Le code ci-dessous montre comment @BeforeMethod et @AfterMethod gèrent les étapes répétées.

package firsttestngpackage;

import org.openqa.selenium.By;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.testng.Assert;
import org.testng.annotations.*;

public class FirstTestNGFile {

    public String baseUrl = "https://demo.guru99.com/test/newtours/";
    public WebDriver driver;
    public String expected = null;
    public String actual = null;

    @BeforeTest
    public void launchBrowser() {
        System.out.println("launching firefox browser");
        driver = new FirefoxDriver();
        driver.get(baseUrl);
    }

    @BeforeMethod
    public void verifyHomepageTitle() {
        String expectedTitle = "Welcome: Mercury Tours";
        String actualTitle = driver.getTitle();
        Assert.assertEquals(actualTitle, expectedTitle);
    }

    @Test(priority = 0)
    public void register() {
        driver.findElement(By.linkText("REGISTER")).click();
        expected = "Register: Mercury Tours";
        actual = driver.getTitle();
        Assert.assertEquals(actual, expected);
    }

    @Test(priority = 1)
    public void support() {
        driver.findElement(By.linkText("SUPPORT")).click();
        expected = "Under Construction: Mercury Tours";
        actual = driver.getTitle();
        Assert.assertEquals(actual, expected);
    }

    @AfterMethod
    public void goBackToHomepage() {
        driver.findElement(By.linkText("Home")).click();
    }

    @AfterTest
    public void terminateBrowser() {
        driver.quit();
    }
}

Après avoir exécuté le test, TestNG signale la séquence ci-dessous.

En bref : placez les étapes de configuration à l'intérieur @AvantMéthode et nettoyage ou réinitialisation de la navigation à l'intérieur @AprèsMéthode Ainsi, chaque cas de test commence et se termine dans un état connu.

Résumé des TestNG Annotations

• @BeforeSuite : s'exécute avant tous les tests de la suite.
• @AfterSuite : s'exécute après tous les tests de la suite.
• @AvantTest : s'exécute avant toute méthode de test appartenant aux classes à l'intérieur d'un étiqueter.
• @AfterTest : s'exécute après toutes les méthodes de test appartenant aux classes à l'intérieur d'un étiqueter.
• @BeforeGroups : s'exécute peu avant la première méthode de test appartenant à un groupe listé.
• @AfterGroups : s'exécute peu après la dernière méthode de test appartenant à un groupe listé.
• @AvantLeCours : s'exécute avant la première méthode de test de la classe actuelle.
• @AprèsLesCours : s'exécute après toutes les méthodes de test de la classe actuelle.
• @BeforeMethod : s'exécute avant chaque méthode de test.
• @AfterMethod : s'exécute après chaque méthode de test.
• @Test: désigne la méthode comme un cas de test.

FAQ