Grupper i TestNG

Af: Krishna Rungta Krishna Rungta
Hours Opdateret

⚡ Smart opsummering

Grupper i TestNG giver dig mulighed for at tagge testmetoder med logiske etiketter og derefter inkludere eller ekskludere dem via en XML-suite. Denne tilgang forenkler røg-, regressions- og afhængighedsdrevne kørsel uden omskrivning. Java kode.

  • 🏷️ Annotationssyntaks: Brug @Test(groups = {"smoke","regression"}) at mærke en hvilken som helst metode med et eller flere logiske gruppenavne.
  • 📜 XML-kontrol: <groups><run><include> og <exclude> Taggene i testng.xml bestemmer, hvilke taggede metoder der rent faktisk udføres.
  • 🔗 Afhængigheder: dependsOnGroups Attributtstyrker rækkefølge, så forudsatte grupper altid afsluttes, før afhængige tests starter.
  • 🤖 AI-valg: AI-test-påvirkningsværktøjer knytter kodeændringer til relevante grupper, så kun berørte suiter kører på hver commit.
  • 🧪 TestNG 7.x: Moderne udgivelser holder grupper fuldt kompatible med parallel udførelse, lyttere og Maven Surefire-pipelines.
Læs mere

Grupper i TestNG

TestNG er et testframework, der dækker enheds-, funktionelle-, end-to-end-, UI- og integrationstests for Java projekter.

Du kan køre en enkelt pakke eller mange pakker (en pakke indkapsler relaterede klasser i et defineret mappelayout) ved at oprette en XML-suite og udløse den via Maven.

TestNG Grupper med eksempel

Du bruger grupper i TestNG hvornår:

  • Du ønsker ikke at sprede testmetoder på tværs af mange klasser udelukkende efter funktionelt område, og
  • Du ønsker at springe over (ikke udføre) udvalgte testcases, som om de var fraværende i kodebasen.
  • For at opnå begge mål, tagger du metoder i logiske grupper. TestNG respekterer derefter filtrene "include" og "exclude", der er deklareret i XML-pakken.

Uddraget nedenfor viser den gruppemærkningssyntaks, der bruges i en testmetode.

@Prøve (grupper = { "binding", "stærke_bånd" })

Her bruges to gruppenavne, nemlig bonding og strong_tiesDisse er logiske etiketter, som du kan omdøbe, så de passer til dit projekt.

<groups> Tagget markerer starten på gruppefiltre i XML-pakken.

Derefter tilpasser du XML'en til at vælge en valgt gruppe fra de taggede klasser. Eksemplet nedenfor viser gruppedeklarationens syntaks.

<grupper>
<køre>
<omfatter navn="binding" />
</køre>
</grupper>

Antag, at en enkelt klasse indeholder 10 testmetoder.

Ud af disse metoder:

  • 6 metoder bærer bonding gruppe, og
  • 4 metoder bærer strong_ties gruppe.

Dernæst konfigurerer du Maven og Java stier og brug Eclipse IDE til at demonstrere gruppebrug gennem XML-filer inde i en Java-baseret Maven-projekt.

RELATEREDE ARTIKLER

Opret XML til TestNG med tags

  • XML-filen (Extensible Markup Language) i Maven-frameworket gemmer konfigurationen for en eller flere tests, der er deklareret i tag.
  • Hver testindtastning er pakket ind i en mærke og kan indeholde en eller flere TestNG klasser.
  • A Java klasse med en eller flere @Prøve annotationer på dens metoder behandles som en TestNG klasse.

Flere tags vises i rækkefølge for at opbygge en fungerende testng.xml-fil, nemlig , , og .

  • tag indeholder navnet på suite-niveau, der bruges i TestNG rapporter til udførelsesresuméer.
  • <test name=”Guru 99 Røgtestdemo”> Tagget indeholder et logisk testnavn; rapporten bruger det til antallet af beståede, ikke beståede og oversprungne testpersoner plus den samlede udførelsestid og gruppens metadata.
  • tag peger på testklassen, hvor com.group.guru99 er pakken og TC_Class1 er klassens navn.

<!DOKTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite navn="Suite">
<prøve navn="Guru 99 Røgtestdemo”>
<grupper>
<køre>
<omfatter navn="stærke_bånd" />
</køre>
</grupper>
<klasser>
<klasse navn="com.group.guru99.TC_Class1" />
</klasser>
</prøve>
</suite>

Denne XML-konfiguration refereres til i videogennemgangene i de næste afsnit.

"exclude" eller "include" i test-XML

Hvis gruppemekanismen føles tung for et lille filter, giver testng.xml-pakken dig også mulighed for at ekskludere eller inkludere individuelle testmetoder efter navn.

Ekskluder tagSyntaks for ekskluderingstagudelukke navn="${TEST_CASE_NAME}" />
Inkluder tagSyntaks for include-taggetomfatter navn="${TEST_CASE_NAME}" />

Bemærk: Du kan inkludere eller ekskludere mange testtilfælde i en enkelt kørsel, og den samme syntaks gælder for gruppefiltre.

Brug af dependsOnGroups til ordret udførelse

Ud over almindelig inkludering, TestNG lader én gruppe være afhængig af en anden ved hjælp af dependsOnGroups attribut. Løberen sikrer, at alle metoder i den overordnede gruppe afsluttes, før en afhængig metode starter, hvilket holder forudsætningerne pålidelige.

  • Log ind først, derefter transaktioner: Tag loginmetoder med group = "auth"og tagoverførselstests med dependsOnGroups = {"auth"}Overførselstestene kører kun efter login er gennemført.
  • Spring over ved fejl: Hvis en metode i den overordnede gruppe fejler, TestNG markerer de afhængige metoder som sprunget over i stedet for at fejle direkte, hvilket holder rapporterne ærlige.
  • Kombinér med alwaysRun: Oprydningsmetoder bør indstilles alwaysRun = true så nedbrydningen fortsætter, selv når en upstream-gruppe fejler.

Dette mønster er almindeligt for end-to-end-pakker, hvor API-opsætningen skal fuldføres, før UI-påstande starter.

Kør TestNG Grupper, medtag, ekskludér kode (videodemo)

Nedenfor er en gennemgang af Java kode og XML-pakken, der driver gruppere, ekskludere og inkludere adfærd.

Testscenarie: Start Guru99 demobankside, bekræft et par elementer på loginsiden, indtast legitimationsoplysninger, og bekræft et par elementer på dashboardet igen efter login.

Kør TestNG Gruppér, inkludér, ekskludér Code

Bemærk: Hvert trin har sin egen metode, men rækkefølgen afhænger under kørsel af posterne i XML-pakken.

  • Metode 1: Initialiser browseren og start den URL (tc01LaunchURL()).
  • Metode 2: Bekræft overskriften på loginsiden (tc02VerifyLaunchPage()).
  • Metode 3: Indtast brugernavn og adgangskode på loginformularen (tc03EnterCredentials()).
  • Metode 4: Bekræft tilstedeværelsen af ​​Manager-ID'et på brugerdashboardet (tc04VerifyLoggedInPage()).
  • Metode 5: Bekræft yderligere links på brugerdashboardet (tc05VerifyHyperlinks()).

Code for scenariet:

pakke com.gruppe.guru99;

importere java.util.concurrent.TimeUnit;

importere org.openqa.selenium.By;
importere org.openqa.selenium.WebDriver;
importere org.openqa.selenium.firefox.FirefoxChauffører;
importere org.testng.Assert;
importere org.testng.annotations.Test;

offentlig klasse TC_Klasse1 {
offentlig statisk finale webdriver webDriver = ny FirefoxChauffør();

String startSideOverskrift = "//h3[tekst()='Guru99 Bank]”;
endelige String brugernavn_element = "//input[@navn='uid']", adgangskodeelement = "//indtast[@navn='adgangskode']",
login_element = "//input[@navn='btnLogin']";
endelige String brugernavn_værdi = "mngr28642", adgangskodeværdi = "ydAnate";
endelige String leder-ID = "//td[indeholder(tekst(),'Leder-ID')]";
endelige String nyKunde = "//a[@href='tilføjkundeside.php']", fondsoverførsel = "//a[@href='FundTransInput.php']";

/** Denne testcase initialiserer webDriveren */
@Prøve(grupper = { "binding", "stærke_bånd" })
offentligt tomrum tc01LaunchURL() {
webDriver.manage().window().maximize();
webDriver.manage().timeouts().implicitWait(20, Tidsenhed.SEKUNDER);
webDriver.get("https://www.demo.guru99.com/V4/");
}

/** Kontrollerer tilstedeværelsen af ​​overskriften på loginsiden */
@Prøve(grupper = { "binding" })
offentligt tomrum tc02VerifyLaunchPage() {
Assert.assertTrue(webDriver.findElement(By.xpath(launchPageHeading)).isDisplayed(),
"Overskriften på hjemmesiden vises ikke");
System.out.println("Overskriften for hjemmesiden vises");
}

/** Indtaster brugernavn og adgangskode og klikker derefter på login */
@Prøve(grupper = { "binding", "stærke_bånd" })
offentligt tomrum tc03EnterCredentials() {
webDriver.findElement(By.xpath(brugernavn_element)).sendKeys(brugernavn_værdi);
webDriver.findElement(By.xpath(password_element)).sendKeys(password_value);
webDriver.findElement(By.xpath(signIn_element)).klik();
}

/** Bekræfter manager-ID'et på dashboardet */
@Prøve(grupper = { "stærke_bånd" })
offentligt tomrum tc04VerifyLoggedInPage() {
Assert.assertTrue(webDriver.findElement(By.xpath(managerID)).isDisplayed(),
"Leder-ID-mærkat vises ikke");
System.out.println("Manager-ID-mærkat vises");
}

/** Tjekker linket Ny kunde og linket FundTransfer på dashboardet */
@Prøve(grupper = { "binding" })
offentligt tomrum tc05VerifyHyperlinks() {
Assert.assertTrue(webDriver.findElement(By.xpath(newCustomer)).isEnabled(),
"Nyt kundehyperlink vises ikke");
System.out.println("Nyt kundehyperlink vises");

Assert.assertTrue(webDriver.findElement(By.xpath(fundTransfer)).isEnabled(),
"Hyperlink til pengeoverførsel vises ikke");
System.out.println("Hyperlink til pengeoverførsel vises");
}
}

Bemærk: Demobankoplysningerne forbliver gyldige i cirka 20 dage, så en lokal kørsel kan vise en fejlmeddelelse om ugyldige legitimationsoplysninger, når dette vindue er udløbet.

Forklaring af koden:

Fem testmetoder, én pr. handling, har hver en groups attribut på @Test anmærkning.

De to logiske gruppebetegnelser er strong_ties og bonding.

  • Den første og tredje metode anvender begge bonding og strong_ties, så de kører, når en af ​​grupperne er inkluderet i pakken. Dette er et almindeligt mønster for delte test sag trin.
  • Den anden metode er kun mærket med bonding, så den kører kun når bonding gruppen er inkluderet.
  • Den fjerde metode er kun mærket med strong_ties, så den kører kun, når den pågældende gruppe er inkluderet.
  • Den femte metode er kun mærket med bonding, så den kører kun når bonding gruppen er inkluderet.

Fire udførelsesscenarier følger:

Scenario 1: Kør alle testmetoder uanset gruppe. Fjern <groups> blok fra den kørende XML.

Scenario 2: Kør kun metoder knyttet til en valgt gruppe, nemlig strong_ties or bondingSe venligst videoen nedenfor.

  • I den første del af videoen, <groups> Blokken kommenteres ud, så alle testmetoder kører.
  • I den anden del gendannes gruppefilteret, og kun de matchende metoder kører.

Scenario 3: Anvend ekskluderingsfilteret for at springe udvalgte testtilfælde over. Se videoen.

  • Demoen udelukker tc02 efter navn i den kørende XML, og resultatrapporten bekræfter, at den udeladte metode ikke kører.

Scenario 4: Anvend inkluderingsfilteret til kun at køre tc01LaunchURL, tc03EnterCredentialsog tc05VerifyHyperlinksSe venligst videoen.

I denne kørsel udføres kun de metoder, der er angivet i include-filteret, nøjagtigt som konfigureret.

Download eksempelprojektet fra linket nedenfor.

Download ovenstående Code

Konklusion

Grupper i TestNG bringe struktur til det store Selenium og enhedssuiter ved at erstatte engangsklasseopdelinger med deklarative XML-filtre.

Mærk dine metoder med @Test(groups = {...}), brug derefter <include>, <exclude>og dependsOnGroups at drive røg, regression og end-to-end-kørsler fra det samme Maven-projekt på TestNG 7.x.

Ofte Stillede Spørgsmål

En gruppe er en logisk betegnelse, der er knyttet til en testmetode via groups attribut på @TestXML-pakken vælger derefter grupper ved hjælp af inkluderings- og ekskluderingsfiltre, så du bestemmer under kørsel, hvilke taggede metoder der udføres.

Indendørs <groups><run>, <include name="..."> tag hvidlistegrupper for kørslen, og <exclude name="..."> blokerer dem. TestNG anvender ekskluderinger efter inkluderinger, så en ekskluderet gruppe altid springes over, selv når den også er angivet i inkludering.

dependsOnGroups attribut på @Test kræfter TestNG at køre alle metoder i den anførte gruppe, før den afhængige metode starter. Hvis en forudsat metode fejler, TestNG markerer den afhængige metode som sprunget over i stedet for mislykket.

Ja. Det groups attributten accepterer et array, så @Test(groups = {"smoke", "regression"}) placerer én metode i begge grupper. TestNG kører den metode, når en af ​​grupperne er inkluderet i pakken, hvilket holder delte trin TØRE.

TestNG 7.x er den vedligeholdte linje, med udgivelser under org.testng:testng Maven-koordinatsystem. Det holder grupper, parallel udførelse og lyttere fuldt kompatible med moderne Selenium 4 og JDK 17 projekter.

AI-test-impact-værktøjer analyserer kodeforskelle og knytter derefter ændrede klasser til de grupper, der dækker dem. Pipelinen kører kun de taggede grupper på hver pull request, hvilket reducerer feedbacktiden, samtidig med at den holderping risikable stier under afprøvning.

Ja. AI-klyngealgoritmer læser historiske fejllogfiler, markerer ustabile tests og foreslår et stabilt delmængde tagget som regressionIngeniørerne godkender derefter listen TestNG kører den gruppe hver nat, hvilket holder suiten tæt uden at miste dækningen.

Opsummer dette indlæg med: