TestNG Handledning

Vad är TestNG?

TestNG är ett ramverk för automatiseringstestning där "NG" står för "Next Generation". TestNG är inspirerad av JUnit och användningar Java annoteringar (@) för att kontrollera testflödet. Det övervinner JUnits tidigare begränsningar och är utformad för att göra test från slut till slut lättare.

Med TestNG Du kan generera en korrekt rapport och omedelbart se hur många tester som godkänts, misslyckats eller hoppats över. Du kan också köra om endast de misslyckade fallen.

Till exempel:

• Anta att du har fem testfall, vart och ett med sin egen metod, skrivna utan TestNGTre godkända; den fjärde misslyckas. Efter att ha åtgärdat den fjärde vill du bara köra den igen, eftersom de tre första redan har godkänts. Detta är svårt att göra med vanlig main()-metodkod.
• TestNG tillhandahåller en testng-failed.xml fil i test-output mapp. Att köra den XML-filen kör endast de misslyckade fallen igen.

Utöver det kommer du att lära dig fördelarna med TestNG, hur man skriver testmetoder med @Test-annoteringar och hur man konverterar sina klasser till en testsvit som körs från Eclipse eller kommandoraden.

Varför använda TestNG med Selenium?

Som standard Selenium tester ger inte snyggt formaterade resultat. Med TestNG När den är inkopplad genererar testköraren en strukturerad rapport som du kan dela med teamet.

bro Selenium användarna föredrar TestNG över JUnit på grund av dess bredare funktionsuppsättning. De viktigaste funktionerna för Selenium är:

• Rapporter som inkluderar antalet körda, godkända, misslyckade och hoppade över testfall.
• Lätt grogping av testfall via en testng.xml fil, med exekveringsprioriteter.
• Upprepa ett test flera gånger utan loopar med invocationCount.
• Kör flera tester på flera webbläsare — korsviswebbläsartestning stöd.
• Smidig integration med Maven, Jenkinsoch andra CI-verktyg.
• Readable anteckningar — till exempel @BeforeMethod, @EfterMethod, @BeforeTest, @EfterTest.
• Selenium WebDriver har ingen inbyggd rapportering; TestNG fyller det gapet med en ren HTML-rapport som den nedan.

• TestNG förenklar testkoden. Du behöver inte längre en statisk huvudmetod; annoteringar avgör vad som körs och när.

• Oupptäckta undantag hanteras smidigt av TestNGDe rapporteras som misslyckade steg utan att hela körningen avslutas.

Fördelar med TestNG över JUnit

TestNG erbjuder tre stora fördelar jämfört med JUnit:

• Annoteringar är lättare att förstå och använda.
• Testfall kan grupperas och prioriteras med mindre ansträngning.
• Parallell testkörning stöds direkt ur lådan.

Vad är en annotering i TestNG?

Anteckningar i TestNG är kodrader som placeras ovanför en metod för att styra hur den exekveras. De börjar alltid med @-tecknet. Ett enkelt exempel visas nedan.

Annoteringar behandlas i detalj i avsnittet "Annoteringar som används i TestNG" senare i den här handledningen, så exemplet ovan är bara för att sätta förväntningar. TestNG annoteringar är enklare att koda och läsa än JUnit ekvivalenter, och de är viktiga när man kör tester på Selenium Rutnät där parallell exekvering är viktig.

Hur man skriver testfall i TestNG

Skriva a TestNG testfallet tar tre steg:

1. Skriv din affärslogik och placera den TestNG anteckningar ovanför varje metod.
2. Lägg till metadata som klassnamn, gruppnamn och paketnamn.
3. Kör TestNG klassen från din IDE eller kommandoraden.

Skapa ett testfall med hjälp av TestNG Anteckningar

Nu ska vi skapa vårt första testfall med hjälp av TestNG anteckningar i SeleniumInnan du skriver testet, skapa ett nytt TestNG projekt i Eclipse och kalla det FörnamnTestNGProjekt.

Konfigurera en ny TestNG Projekt

Steg 1) Klicka Arkiv > Nytt > Java Projekt.

Steg 2) ange FörnamnTestNGProjekt som projektnamn och klicka på Nästa.

Steg 3) Importera TestNG bibliotek. Klicka på bibliotek fliken och sedan Lägg till bibliotek….

Steg 4) I Lägg till bibliotek dialog, välj TestNG och klicka Nästa.

Steg 5) Klicka Finish.

TestNG borde nu visas i bibliotekslistan.

Steg 6) Lägg till JAR-filerna som innehåller Selenium API. Dessa kommer från Java klientdrivrutinen hämtad från selenium.dev/nedladdningar.

Navigera till mappen där Selenium JAR-filer lagras.

Efter att du har lagt till de externa JAR-filerna bör skärmen se ut så här.

Steg 7) Klicka Finish. Den nya FörnamnTestNGProjekt visas i Paketutforskaren.

Hur man skapar en ny TestNG Testfil

När projektet är klart, skapa ett nytt TestNG fil.

Steg 1) Högerklicka på src mapp och välj Nytt > Annat….

Steg 2) Expandera TestNG mapp, välj TestNG klass, och klicka Nästa.

Steg 3) Ange värdena som visas nedan och klicka Finish. De Java filen heter FörnamnTestNGFil.

Steg 4) Eclipse genererar TestNG mallen som visas nedan.

Kodning av din första TestNG Testfall

Skapa den första testfall som verifierar titeln på Mercury Tours hemsida.

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

Saker att lägga märke till:

• TestNG behöver inte a main() metod.
• Metoder behöver inte vara statiska.
• Ocuco-landskapet @Testa anteckningsmärken verifyHomepageTitle() som ett testfall.
• Annoteringar finns i org.testng.annotations.* paket.
• Ocuco-landskapet Hävda klass från org.testng.Assert driver verifieringar.

Du kan ha flera @Test-annoteringar i en och samma TestNG filen. Vi tar upp det i "Annoteringar som används i TestNG" sektion.

Kör testet

Högerklicka på filen och kör den som en TestNG testet. Eclipse producerar två utdata — ett textresultat i konsolfönstret och ett grafiskt resultat i TestNG Resultatfönster.

Kontrollera rapporter skapade av TestNG

Konsolfönstret visar en textbaserad sammanfattning medan TestNG Resultatfönstret visar en grafisk vy.

Generera HTML-rapporter

TestNG kan också generera fullständiga HTML-rapporter.

Steg 1) Efter körning FörnamnTestNGFil, högerklicka på projektet och välj refresh.

Steg 2) A testutdata mappen visas. Expandera den och leta reda på index.html — HTML-rapporten för den senaste körningen.

Steg 3) Double-klick index.html att öppna den inuti Eclipses webbläsare. Tryck F5 för att uppdatera efter framtida körningar.

Annoteringar som används i TestNG

Du har redan sett @Test-annoteringen. Resten av det här avsnittet behandlar de mest användbara avancerade annoteringarna.

Flera testfall

En enda TestNG filen kan innehålla flera @Test-annoteringar. Som standard körs metoder som annoteras med @Test i alfabetisk ordning. I koden nedan, metoder c_test, a_testoch b_test körs alfabetiskt oavsett källordning.

Kör koden och öppna index.html. Klicka Kronologisk vy.

Driftparametrar

För att åsidosätta standardordningen, använd priority parameter. Parametrar är nyckelord som modifierar en annoterings beteende.

• Tilldela ett värde med =.
• Radbryt parametrar inom parenteser som placeras omedelbart efter annoteringen, som visas nedan.

TestNG kör @Test-annoteringar från det lägsta prioritetsvärdet till det högsta. Prioritetsnumren behöver inte vara i följd.

HTML-rapporten bekräftar att metoderna kördes i stigande prioritetsordning.

Flera parametrar

Förutom priority, @Test accepterar alwaysRun parameter (sant eller falskt). För att använda två eller fler parametrar i en enda annotering, separera dem med ett kommatecken:

@Test(priority = 0, alwaysRun = true)

@BeforeTest och @AfterTest

@BeforeTest	Metoder under denna annoteringskörning före det första testfallet i TestNG fil.
@AfterTest	Metoder under denna annoteringskörning efter alla testfall i TestNG filfinish.

Tänk på koden nedan.

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

Från tabellen och koden kan vi förutsäga att sekvensen blir:

• 1:a — launchBrowser()
• 2:a — verifyHomepageTitle()
• 3:e — terminateBrowser()

Placeringen av annoteringsblock i källfilen påverkar inte deras exekveringsordning. Försök att omorganisera metoderna enligt nedan.

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 och verifiera resultatet.

@BeforeMethod och @AfterMethod

@BeforeMethod	Metoder under denna annoteringskörning före varje testmetod.
@AfterMethod	Metoder under denna annoteringskörning efter varje testmetod.

In Mercury Turer, anta att vi vill verifiera titlarna på två målsidor som nås från startsidan.

Testets förlopp är:

• Öppna startsidan och verifiera dess titel.
• Klicka på REGISTRERA och verifiera titeln på dess målsida.
• Gå tillbaka till startsidan och verifiera titeln.
• Klicka på SUPPORT och verifiera titeln på dess målsida.
• Gå tillbaka till startsidan och verifiera titeln igen.

Koden nedan visar hur @BeforeMethod och @AfterMethod hanterar de upprepade stegen.

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 att ha kört testet, TestNG rapporterar sekvensen nedan.

Kort sagt: placera installationsstegen inuti @BeforeMethod och rensning eller återställning av navigering inuti @AfterMethod så varje testfall börjar och slutar i ett känt tillstånd.

Sammanfattning av TestNG Anteckningar

• @BeforeSuite: körs före alla tester i sviten.
• @AfterSuite: körs efter alla tester i sviten.
• @FöreTest: körs före någon testmetod som tillhör klasserna inuti en märka.
• @EfterTest: körs efter alla testmetoder som tillhör klasserna inuti en märka.
• @FöreGrupper: körs strax före den första testmetoden som tillhör någon listad grupp.
• @EfterGrupper: körs strax efter den sista testmetoden som tillhör någon listad grupp.
• @FöreKlassen: körs före den första testmetoden i den aktuella klassen.
• @EfterKlassen: körs efter alla testmetoder i den aktuella klassen.
• @FöreMetoden: körs före varje testmetod.
• @EfterMetoden: körs efter varje testmetod.
• @Testa: markerar metoden som ett testfall.

Vanliga frågor