TestNG Poradnik

Czym jest TestNG?

TestNG jest platformą do automatyzacji testów, gdzie „NG” oznacza „Next Generation” (Następna Generacja). TestNG jest inspirowany JUnit i wykorzystuje Java adnotacje (@) do kontrolowania przepływu testów. To przezwycięża JUnitwcześniejsze ograniczenia i jest zaprojektowany tak, aby testy end-to-end łatwiejsze.

Z TestNG Możesz wygenerować odpowiedni raport i natychmiast zobaczyć, ile testów zostało zaliczonych, niezaliczonych lub pominiętych. Możesz również ponownie uruchomić tylko te przypadki, które zakończyły się niepowodzeniem.

Na przykład:

• Załóżmy, że masz pięć przypadków testowych, każdy w swojej własnej metodzie, napisanych bez TestNG. Trzy przejścia; czwarte kończy się niepowodzeniem. Po poprawieniu czwartego, chcesz ponownie uruchomić tylko ten jeden, ponieważ pierwsze trzy już przeszły. Trudno to zrobić za pomocą zwykłego kodu metody main().
• TestNG zapewnia testng-failed.xml Plik w test-output folder. Uruchomienie tego pliku XML powoduje ponowne wykonanie tylko tych przypadków, w których wystąpił błąd.

Poza tym poznasz zalety TestNG, jak pisać metody testowe z adnotacjami @Test i jak konwertować klasy na zestaw testów, który będzie uruchamiany z Eclipse lub wiersza poleceń.

Dlaczego warto korzystać TestNG w Selenium?

Domyślnie Selenium testy nie dają ładnie sformatowanych wyników. TestNG Po podłączeniu moduł uruchamiający testy generuje ustrukturyzowany raport, którym możesz podzielić się z zespołem.

Większość Selenium użytkownicy wolą TestNG koniec JUnit ze względu na szerszy zestaw funkcji. Kluczowe funkcje dla Selenium należą:

• Raporty zawierające liczbę przypadków testowych uruchomionych, zaliczonych, niezaliczonych i pominiętych.
• Łatwa grupaping przypadków testowych za pośrednictwem testng.xml plik z priorytetami wykonania.
• Powtarzaj test wielokrotnie bez użycia pętli invocationCount.
• Przeprowadź wiele testów w wielu przeglądarkach — między przeglądarkamitestowanie przeglądarki Wsparcie.
• Płynna integracja z Maven, Jenkinsi innych narzędzi CI.
• Readable adnotacje — na przykład @BeforeMethod, @AfterMethod, @BeforeTest, @AfterTest.
• Selenium WebDriver nie ma wbudowanego modułu raportowania; TestNG wypełnia tę lukę czystym raportem HTML, takim jak ten poniżej.

• TestNG Upraszcza kod testowy. Nie potrzebujesz już statycznej metody main; adnotacje decydują, co i kiedy zostanie uruchomione.

• Nieprzechwycone wyjątki są obsługiwane z gracją przez TestNGSą one zgłaszane jako nieudane kroki bez przerywania całego przebiegu.

Zalety TestNG koniec JUnit

TestNG oferuje trzy główne zalety w porównaniu JUnit:

• Adnotacje są łatwiejsze do zrozumienia i użycia.
• Przypadki testowe można grupować i ustalać priorytety przy mniejszym wysiłku.
• Równoległe wykonywanie testów jest obsługiwane domyślnie.

Czym jest adnotacja w TestNG?

Adnotacje w TestNG są to wiersze kodu umieszczone nad metodą, kontrolujące sposób jej wykonania. Zawsze zaczynają się od symbolu @. Poniżej znajduje się prosty przykład.

Adnotacje omówiono szczegółowo w sekcji „Adnotacje używane w TestNG" później w tym samouczku, więc powyższy przykład ma jedynie na celu ustalenie oczekiwań. TestNG adnotacje są łatwiejsze do kodowania i czytania niż JUnit odpowiedniki i są one niezbędne podczas przeprowadzania testów na Selenium Krata gdzie równoległe wykonywanie zadań ma znaczenie.

Jak pisać przypadki testowe w TestNG

Pisanie TestNG przypadek testowy składa się z trzech kroków:

1. Napisz swoją logikę biznesową i umieść ją TestNG adnotacje nad każdą metodą.
2. Dodaj metadane, takie jak nazwa klasy, nazwa grupy i nazwa pakietu.
3. Uruchom TestNG klasę ze swojego IDE lub wiersza poleceń.

Utwórz przypadek testowy za pomocą TestNG Adnotacje

Teraz utworzymy nasz pierwszy przypadek testowy, używając TestNG adnotacje w Selenium. Przed napisaniem testu skonfiguruj nowy TestNG projekt w Eclipse i nazwij to ImięTestNGProjekt.

Konfigurowanie nowego TestNG Projekt

Krok 1) Kliknij Plik > Nowy > Java Projekt.

Krok 2) Wchodzę ImięTestNGProjekt jako nazwę projektu i kliknij Następna.

Krok 3) Importuj TestNG biblioteki. Kliknij biblioteki kartę, a następnie Dodaj bibliotekę….

Krok 4) W Dodaj bibliotekę dialog, wybierz TestNG i kliknij Następna.

Krok 5) Kliknij Zakończyć.

TestNG powinien teraz pojawić się na liście bibliotek.

Krok 6) Dodaj pliki JAR zawierające Selenium API. Pochodzą one z Java sterownik klienta pobrany z selenium.dev/downloads.

Przejdź do folderu, w którym znajduje się Selenium Pliki JAR są przechowywane.

Po dodaniu zewnętrznych plików JAR ekran powinien wyglądać następująco.

Krok 7) Kliknij Zakończyć. Nowy ImięTestNGProjekt pojawia się w Eksploratorze pakietów.

Jak stworzyć nowy TestNG Plik testowy

Po przygotowaniu projektu utwórz nowy TestNG plik.

Krok 1) Kliknij prawym przyciskiem myszy src folder i wybierz Nowe > Inne….

Krok 2) rozwiń TestNG wybierz folder TestNG klasai kliknij Następna.

Krok 3) Wprowadź wartości pokazane poniżej i kliknij Zakończyć, Java plik ma nazwę ImięTestNGfilet.

Krok 4) Eclipse generuje TestNG szablon pokazany poniżej.

Kodowanie Twojego pierwszego TestNG Przypadek testowy

Utwórz pierwszy walizka testowa który weryfikuje tytuł Mercury Strona główna wycieczek.

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

Rzeczy, na które należy zwrócić uwagę:

• TestNG nie potrzebuje main() Metoda.
• Metody nie muszą być statyczne.
• @Test znaki adnotacji verifyHomepageTitle() jako przypadek testowy.
• Adnotacje są dostępne na żywo org.testng.annotations.* pakiet.
• Twierdzić klasa od org.testng.Assert napędza weryfikacje.

W jednej adnotacji @Test może znajdować się wiele adnotacji @Test TestNG Plik. Omówimy to w „Adnotacje używane w TestNG"

Uruchamianie testu

Kliknij plik prawym przyciskiem myszy i uruchom go jako TestNG test. Eclipse generuje dwa wyniki — wynik tekstowy w oknie konsoli i wynik graficzny w TestNG Okno wyników.

Sprawdzanie raportów utworzonych przez TestNG

Okno konsoli zapewnia podsumowanie w formie tekstowej, podczas gdy TestNG Okno wyników wyświetla widok graficzny.

Generowanie raportów HTML

TestNG może również generować pełne raporty HTML.

Krok 1) Po bieganiu ImięTestNGfilet, kliknij prawym przyciskiem myszy projekt i wybierz Odśwież kod.

Krok 2) A wyjście testowe Pojawi się folder. Rozwiń go i znajdź index.html — raport HTML dla ostatniego uruchomienia.

Krok 3) Double-Kliknij index.html otworzyć to w środku EclipsePrzeglądarka. Naciśnij klawisz F5, aby odświeżyć po kolejnych uruchomieniach.

Adnotacje używane w TestNG

Adnotację @Test już widziałeś. W dalszej części tej sekcji omówiono najbardziej przydatne, zaawansowane adnotacje.

Wiele przypadków testowych

Pojedynczy TestNG Plik może zawierać wiele adnotacji @Test. Domyślnie metody z adnotacją @Test są wykonywane w kolejności alfabetycznej. W poniższym kodzie metody c_test, a_test, b_test wyświetlane alfabetycznie, niezależnie od kolejności podanej w źródle.

Uruchom kod i otwórz index.html. Kliknij Widok chronologiczny.

Parametry

Aby zastąpić domyślną kolejność, użyj priority parametr. Parametry to słowa kluczowe, które modyfikują zachowanie adnotacji.

• Przypisz wartość za pomocą =.
• Parametry należy umieścić w nawiasach umieszczonych bezpośrednio za adnotacją, jak pokazano poniżej.

TestNG Wykonuje adnotacje @Test od najniższej wartości priorytetu do najwyższej. Numery priorytetów nie muszą następować po sobie.

Raport HTML potwierdza, że ​​metody są wykonywane w kolejności rosnącej według priorytetu.

Wiele parametrów

Oprócz priority, @Test akceptuje alwaysRun parametr (prawda lub fałsz). Aby użyć dwóch lub więcej parametrów w jednej adnotacji, rozdziel je przecinkiem:

@Test(priority = 0, alwaysRun = true)

@PrzedTestem i @PoTestie

@Przed testem	Metody w ramach tej adnotacji przed pierwszym przypadkiem testowym w TestNG filet.
@PoTest	Metody w ramach tej adnotacji po wszystkich przypadkach testowych w TestNG wykończenie pliku.

Rozważ poniższy kod.

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

Na podstawie tabeli i kodu możemy przewidzieć, że sekwencja będzie wyglądać następująco:

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

Umiejscowienie bloków adnotacji w pliku źródłowym nie ma wpływu na kolejność ich wykonywania. Spróbuj zmienić metody, jak pokazano poniżej.

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

Uruchom kod i sprawdź wynik.

@BeforeMethod i @AfterMethod

@Bez tytułu	Metody w ramach tej adnotacji przed każdą metodą testową.
@Poradnik	Metody w ramach tej adnotacji po każdej metodzie testowej.

In Mercury Wycieczki, załóżmy, że chcemy zweryfikować tytuły dwóch stron docelowych, do których uzyskano dostęp ze strony głównej.

Przebieg testu jest następujący:

• Otwórz stronę główną i sprawdź jej tytuł.
• Kliknij ZAREJESTRUJ SIĘ i sprawdź tytuł strony docelowej.
• Wróć na stronę główną i zweryfikuj tytuł.
• Kliknij WSPARCIE i sprawdź tytuł strony docelowej.
• Wróć na stronę główną i ponownie zweryfikuj tytuł.

Poniższy kod pokazuje, jak @BeforeMethod i @AfterMethod obsługują powtarzające się kroki.

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

Po uruchomieniu testu, TestNG podaje sekwencję poniżej.

Krótko mówiąc: umieść kroki instalacyjne wewnątrz @Bez tytułu i czyszczenie lub resetowanie nawigacji w środku @Poradnik więc każdy przypadek testowy zaczyna się i kończy w znanym stanie.

Podsumowanie TestNG Adnotacje

• @BeforeSuite: uruchamia się przed wszystkimi testami w zestawie.
• @AfterSuite: uruchamia się po wszystkich testach w pakiecie.
• @BeforeTest: uruchamia się przed jakąkolwiek metodą testową należącą do klas wewnątrz etykietka.
• @AfterTest: uruchamia się po wszystkich metodach testowych należących do klas wewnątrz etykietka.
• @BeforeGroups: uruchamia się krótko przed pierwszą metodą testową należącą do którejkolwiek z wymienionych grup.
• @AfterGroups: uruchamiana jest krótko po ostatniej metodzie testowej należącej do którejkolwiek z wymienionych grup.
• @BeforeClass: uruchamia się przed pierwszą metodą testową w bieżącej klasie.
• @AfterClass: uruchamia się po wszystkich metodach testowych w bieżącej klasie.
• @BeforeMethod: uruchamia się przed każdą metodą testową.
• @AfterMethod: uruchamia się po każdej metodzie testowej.
• @Test: oznacza metodę jako przypadek testowy.

FAQ