TestNG tutorial

Hvad er TestNG?

TestNG er et framework for automatiseringstest, hvor "NG" står for "Next Generation". TestNG er inspireret af JUnit og anvendelser Java annotationer (@) til at styre testflowet. Det overvinder JUnit's tidligere begrænsninger og er designet til at gøre ende-til-ende test lettere.

Med TestNG Du kan generere en ordentlig rapport og straks se, hvor mange tests der bestod, mislykkedes eller blev sprunget over. Du kan også kun køre de mislykkede sager igen.

For eksempel:

• Antag, at du har fem testcases, hver med sin egen metode, skrevet uden TestNGTre beståelser; den fjerde fejler. Efter at have rettet den fjerde, skal du kun køre den ene igen, da de første tre allerede er bestået. Dette er svært at gøre med almindelig main()-metodekode.
• TestNG tilvejebringer en testng-failed.xml fil i test-output mappe. Kørsel af den XML genudfører kun de mislykkede tilfælde.

Derudover vil du lære fordelene ved TestNG, hvordan man skriver testmetoder med @Test-annotationer, og hvordan man konverterer sine klasser til en testsuite, der kører fra Eclipse eller kommandolinjen.

Hvorfor brug TestNG med Selenium?

Som standard Selenium tests producerer ikke pænt formaterede resultater. Med TestNG Når den er tilsluttet, udsender testløberen en struktureret rapport, som du kan dele med teamet.

bro Selenium brugerne foretrækker TestNG i løbet af JUnit på grund af dets bredere funktionssæt. Nøglefunktionerne for Selenium er:

• Rapporter, der inkluderer antallet af kørte, beståede, mislykkede og sprungne tests.
• Let fugningping af testcases via en testng.xml fil med udførelsesprioriteter.
• Gentag en test flere gange uden løkker ved hjælp af invocationCount.
• Kør flere tests på flere browsere — på tværs afbrowser test Support.
• Problemfri integration med Maven, Jenkinsog andre CI-værktøjer.
• Readable annoteringer — for eksempel @BeforeMethod, @EfterMethod, @BeforeTest, @EfterTest.
• Selenium WebDriver har ingen indbygget rapportering; TestNG udfylder dette hul med en ren HTML-rapport som den nedenfor.

• TestNG forenkler testkode. Du behøver ikke længere en statisk main-metode; annotationer bestemmer, hvad der kører, og hvornår.

• Uopfangede undtagelser håndteres elegant af TestNGDe rapporteres som mislykkede trin uden at hele kørslen afsluttes.

Fordele ved TestNG i løbet af JUnit

TestNG tilbyder tre store fordele i forhold til JUnit:

• Annotationer er nemmere at forstå og bruge.
• Testcases kan grupperes og prioriteres med mindre indsats.
• Parallel testudførelse understøttes direkte fra starten.

Hvad er en annotation i TestNG?

Anmærkninger i TestNG er linjer kode placeret over en metode for at kontrollere, hvordan den udføres. De starter altid med @-tegnet. Et simpelt eksempel er vist nedenfor.

Annotationer er beskrevet i detaljer i afsnittet "Annotationer brugt i TestNG" senere i denne vejledning, så eksemplet ovenfor er blot for at sætte forventninger. TestNG Annotationer er nemmere at kode og læse end JUnit ækvivalenter, og de er essentielle, når man kører tests på Selenium Grid hvor parallel udførelse er vigtig.

Sådan skriver du testcases i TestNG

Skrivning a TestNG Testcasen tager tre trin:

1. Skriv din forretningslogik og placering TestNG annotationer over hver metode.
2. Tilføj metadata såsom klassenavn, gruppenavn og pakkenavn.
3. Kør TestNG klasse fra dit IDE eller kommandolinjen.

Opret en testcase ved hjælp af TestNG Annotationer

Nu vil vi oprette vores første testcase ved hjælp af TestNG annotationer i SeleniumInden du skriver testen, skal du oprette en ny TestNG projekt i Eclipse og kalde det FornavnTestNGProjekt.

Opsætning af en ny TestNG Projekt

Trin 1) Klik Fil > Ny > Java Projekt.

Trin 2) Indtast FornavnTestNGProjekt som projektnavnet og klik på Næste.

Trin 3) Importer TestNG biblioteker. Klik på Biblioteker fanebladet og derefter Tilføj bibliotek….

Trin 4) I Tilføj bibliotek dialog, vælg TestNG og klik Næste.

Trin 5) Klik Finish.

TestNG burde nu vises på bibliotekslisten.

Trin 6) Tilføj JAR-filerne, der indeholder Selenium API. Disse kommer fra Java klientdriveren downloadet fra selenium.dev/downloads.

Naviger til den mappe, hvor Selenium JAR-filer gemmes.

Efter tilføjelse af de eksterne JAR-filer, skulle skærmen gerne se sådan ud.

Trin 7) Klik Finish. De nye FornavnTestNGProjekt vises i Pakke Explorer.

Sådan opretter du en ny TestNG Test fil

Når projektet er klar, skal du oprette et nyt TestNG fil.

Trin 1) Højreklik på src mappe og vælg Ny > Andet….

Trin 2) Udvid TestNG mappe, vælg TestNG klasse, og klik Næste.

Trin 3) Indtast de viste værdier nedenfor, og klik på Finish. Det Java filen er navngivet FornavnTestNGFile (Felt).

Trin 4) Eclipse genererer TestNG skabelon vist nedenfor.

Kodning af din første TestNG Test sag

Opret den første test sag der bekræfter titlen på Mercury Tours hjemmeside.

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();
    }
}

Ting at bemærke:

• TestNG behøver ikke en main() fremgangsmåde.
• Metoder behøver ikke at være statiske.
• @Prøve annotationsmærker verifyHomepageTitle() som en testsag.
• Annotationer findes i org.testng.annotations.* pakke.
• Hævde klasse fra org.testng.Assert drevverifikationer.

Du kan have flere @Test-annotationer i en enkelt TestNG fil. Vi dækker det i "Annotationer brugt i TestNG" sektion.

Kører testen

Højreklik på filen og kør den som en TestNG test. Eclipse producerer to output - et tekstresultat i konsolvinduet og et grafisk resultat i TestNG Resultatvindue.

Kontrol af rapporter oprettet af TestNG

Konsolvinduet viser et tekstbaseret resumé, mens TestNG Resultatvinduet viser en grafisk visning.

Generering af HTML-rapporter

TestNG kan også generere komplette HTML-rapporter.

Trin 1) Efter at have kørt FornavnTestNGFile (Felt), højreklik på projektet og vælg Opfrisk.

Trin 2) A test-output mappen vises. Udvid den og find den index.html — HTML-rapporten for den seneste kørsel.

Trin 3) Double-klik index.html at åbne den indeni Eclipses browser. Tryk på F5 for at opdatere efter fremtidige kørsel.

Annotationer brugt i TestNG

Du har allerede set @Test-annotationen. Resten af ​​dette afsnit dækker de mest nyttige avancerede annotationer.

Flere testcases

En enkelt TestNG Filen kan indeholde flere @Test-annotationer. Som standard udføres metoder, der er annoteret med @Test, i alfabetisk rækkefølge. I koden nedenfor udføres metoderne c_test, a_testog b_test køres alfabetisk uanset kilderækkefølge.

Kør koden og åbn index.html. Klik Kronologisk oversigt.

Driftsparametre

For at tilsidesætte standardrækkefølgen skal du bruge priority parameter. Parametre er nøgleord, der ændrer en annotations opførsel.

• Tildel en værdi med =.
• Ombryd parametre i parenteser placeret umiddelbart efter annotationen, som vist nedenfor.

TestNG udfører @Test-annotationer fra den laveste prioritetsværdi til den højeste. Prioritetsnumrene behøver ikke at være fortløbende.

HTML-rapporten bekræfter, at metoderne blev udført i stigende prioritetsrækkefølge.

Flere parametre

Udover priority, @Test accepterer alwaysRun parameter (sand eller falsk). For at bruge to eller flere parametre i en enkelt annotation skal du adskille dem med et komma:

@Test(priority = 0, alwaysRun = true)

@BeforeTest og @AfterTest

@FørTest	Metoder under denne annotationskørsel før den første testcase i TestNG fil.
@EfterTest	Metoder under denne annotationskørsel efter alle testsager i TestNG filfinish.

Overvej koden nedenfor.

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();
    }
}

Ud fra tabellen og koden kan vi forudsige, at sekvensen vil være:

• 1. — launchBrowser()
• 2. — verifyHomepageTitle()
• 3. — terminateBrowser()

Placeringen af ​​annotationsblokke i kildefilen påvirker ikke deres udførelsesrækkefølge. Prøv at omrokere metoderne som vist nedenfor.

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);
    }
}

Kør koden og verificer resultatet.

@BeforeMethod og @AfterMethod

@FørMetode	Metoder under denne annotationskørsel før hver testmetode.
@AfterMethod	Metoder under denne annotationskørsel efter hver testmetode.

In Mercury Rundvisninger, lad os antage, at vi vil verificere titlerne på to målsider, der nås fra hjemmesiden.

Testens forløb er:

• Åbn hjemmesiden og bekræft dens titel.
• Klik på REGISTER og bekræft titlen på dens målside.
• Gå tilbage til forsiden og bekræft titlen.
• Klik på SUPPORT og bekræft titlen på dens målside.
• Gå tilbage til forsiden og bekræft titlen igen.

Koden nedenfor viser, hvordan @BeforeMethod og @AfterMethod håndterer de gentagne trin.

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();
    }
}

Efter at have kørt testen, TestNG rapporterer sekvensen nedenfor.

Kort sagt: placer opsætningstrinnene indeni @FørMetode og oprydning eller nulstilling af navigation indeni @AfterMethod så hver testcase starter og slutter i en kendt tilstand.

Sammenfatning af TestNG Annotationer

• @BeforeSuite: kører før alle tests i pakken.
• @AfterSuite: kører efter alle tests i pakken.
• @FørTest: kører før enhver testmetode, der tilhører klasserne i en mærke.
• @EfterTest: kører efter alle testmetoder, der tilhører klasserne i en mærke.
• @FørGrupper: kører kort før den første testmetode, der tilhører en af ​​de anførte grupper.
• @EfterGrupper: kører kort efter den sidste testmetode, der tilhører en af ​​de anførte grupper.
• @FørKlassen: kører før den første testmetode i den aktuelle klasse.
• @EfterKlassen: kører efter alle testmetoder i den aktuelle klasse.
• @FørMetoden: kører før hver testmetode.
• @EfterMetode: kører efter hver testmetode.
• @Prøve: markerer metoden som en testcase.

Ofte Stillede Spørgsmål