Furnizor de date în TestNG: Selenium Exemplu de parametrizare
⚡ Rezumat inteligent
Parametrizare în Selenium rulează o singură metodă de testare în mod repetat împotriva diferitelor seturi de date, transformând un script într-o acoperire bazată pe date. TestNG oferă două mecanisme pentru aceasta: adnotarea @Parameters susținută de testng.xml și adnotarea @DataProvider care returnează o matrice de obiecte bidimensionale.

Pe măsură ce creăm software, dorim întotdeauna ca acesta să funcționeze corect cu diferite seturi de date. Când vine vorba de de testare Pentru acel software, verificarea unui singur set de date nu este suficientă. Trebuie să verificăm dacă sistemul acceptă fiecare combinație pe care se așteaptă să o suporte. Pentru aceasta, trebuie să parametrizăm scripturile noastre de testare. Aici intervine parametrizarea.
Parametrizare în Selenium
Parametrizare în Selenium este un proces de parametrizare a scripturilor de testare pentru a transmite mai multe date aplicației în timpul execuției. Este o strategie de execuție care rulează automat cazuri de testare de mai multe ori folosind valori diferite. Conceptul realizat prin parametrizarea scripturilor de testare este numit Testare bazată pe date.
Tipul de parametrizare în TestNG
Pentru a clarifica parametrizarea, vom parcurge opțiunile de parametrizare dintr-unul dintre cele mai populare framework-uri pentru Selenium WebDriver — TestNG.
Sunt doua feluri prin care putem realiza parametrizarea în TestNG:
- Cu ajutorul Adnotarea parametrilor si TestNG XML fișier.
- Cu ajutorul Furnizor de date adnotare.
Diagrama de mai sus rezumă împărțirea: parametrii din testng.xml pot fi declarați la nivel de suită sau de test, în timp ce un parametru dintr-un DataProvider poate accepta Method și ITestContext ca argument propriu. Să le studiem în detaliu.
Parametri Adnotare în TestNG
Parametri Adnotare în TestNG este o metodă utilizată pentru a transmite valori metodelor de testare ca argumente folosind un fișier .xml. Utilizatorii pot fi nevoiți să transmită valorile metodelor de testare în timpul execuției. Metoda de adnotare @Parameters poate fi utilizată în orice metodă care are adnotații @Test, @Before, @After sau @Factory.
Adnotarea parametrilor cu Testng.xml
Selectați parametrizarea folosind adnotări atunci când nu doriți să gestionați complexitatea și numărul de combinații de intrări este mic.
Să vedem cum funcționează asta.
Scenariu de testare
Pas 1) Lansați browserul și accesați Google.com
Pas 2) Introduceți un cuvânt cheie de căutare
Pas 3) Verificați dacă valoarea introdusă este aceeași cu valoarea furnizată de datele noastre de testare
Pas 4) Repetați pașii 2 și 3 până când toate valorile sunt introduse
| Autorul testului | Tasta de căutare |
|---|---|
| Guru99 | India |
| Krishna | USA |
| Bhupesh | China |
Iată un exemplu despre cum se face fără parametri:
package parameters; import org.testng.annotations.Test; import org.testng.AssertJUnit; import java.time.Duration; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; public class NoParameterWithTestNGXML { WebDriver driver; @Test public void testNoParameter() throws InterruptedException { String author = "guru99"; String searchKey = "india"; driver = new FirefoxDriver(); driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); driver.get("https://google.com"); WebElement searchText = driver.findElement(By.name("q")); // Searching text in the Google text box searchText.sendKeys(searchKey); System.out.println("Welcome ->" + author + " Your search key is->" + searchKey); Thread.sleep(3000); System.out.println("Value in Google Search Box = " + searchText.getDomProperty("value") + " ::: Value given by input = " + searchKey); // Verifying the value in the Google search box AssertJUnit.assertTrue(searchText.getDomProperty("value").equalsIgnoreCase(searchKey)); } }
⚠️ Selenium Notă din 4: Trei linii din versiunea originală a acestui exemplu nu se mai compilează sau sunt depreciate în versiunea curentă Selenium de presă. System.setProperty("webdriver.gecko.driver", …) este inutil din Selenium 4.6 în continuare, deoarece Selenium Manager rezolvă automat fișierul binar al driverului. implicitlyWait(10, TimeUnit.SECONDS) supraîncărcarea a fost eliminată în Selenium 4 și înlocuit de implicitlyWait(Duration.ofSeconds(10)). getAttribute() a fost depreciat în Selenium 4.27, deci citirea unei casete de text folosește getDomProperty("value")Fiecare exemplu de mai jos aplică aceleași trei corecții.
Studiați exemplul de mai sus și imaginați-vă cât de complex devine codul atunci când acest lucru este repetat pentru trei combinații de intrări.
Acum să o parametrizăm folosind TestNGPentru a face acest lucru, trebuie să:
- Creați un fișier XML care va stoca parametrii
- În test, adăugați adnotarea @Parameters
Iată codul complet.
Nivelul testului TestNG.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd"> <suite name="TestSuite" thread-count="3"> <parameter name="author" value="Guru99" /> <parameter name="searchKey" value="India" /> <test name="testGuru"> <parameter name="searchKey" value="UK" /> <classes> <class name="parameters.ParameterWithTestNGXML"></class> </classes> </test> </suite>
ParameterWithTestNGFișier XML.java
package parameters; import org.testng.AssertJUnit; import java.time.Duration; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.testng.annotations.Optional; import org.testng.annotations.Parameters; import org.testng.annotations.Test; public class ParameterWithTestNGXML { WebDriver driver; @Test @Parameters({"author", "searchKey"}) public void testParameterWithXML(@Optional("Abc") String author, String searchKey) throws InterruptedException { driver = new FirefoxDriver(); driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); driver.get("https://google.com"); WebElement searchText = driver.findElement(By.name("q")); // Searching text in the Google text box searchText.sendKeys(searchKey); System.out.println("Welcome ->" + author + " Your search key is->" + searchKey); Thread.sleep(3000); System.out.println("Value in Google Search Box = " + searchText.getDomProperty("value") + " ::: Value given by input = " + searchKey); // Verifying the value in the Google search box AssertJUnit.assertTrue(searchText.getDomProperty("value").equalsIgnoreCase(searchKey)); } }
Pentru a rula scriptul, selectați fișierul XML și rulați-l ca TestNG pe.
Faceți clic dreapta pe fișierul .xml -> Executare ca -> TestNG Suită (Notă: Suită)
Parametrii pot fi definiți la două niveluri:
- Nivelul suitei — parametrii din interiorul
<suite>eticheta TestNG Fișierele XML sunt parametri la nivel de suită. - Nivelul testului — parametrii din interiorul
<test>eticheta TestNG Fișierele XML sunt parametri de nivel de testare.
Iată același test cu parametri la nivel de suită:
NOTĂ: Dacă numele parametrului este același la nivel de suită și la nivel de testare, parametrul de nivel de testare are prioritate față de parametrul de nivel de suită. În acest caz, toate clasele din interiorul acelui nivel de testare partajează parametrul suprascris, iar clasele din afara acelui nivel de testare continuă să utilizeze parametrul de nivel de suită.
Depanare
Problema # 1: O valoare a unui parametru din testng.xml care nu poate fi convertită la parametrul metodei de testare corespunzătoare generează o eroare.
Luați în considerare următorul exemplu:
Aici, atributul „author” este egal cu „Guru99', care este un șir de caractere, în timp ce metoda de testare corespunzătoare așteaptă o valoare întreagă, deci este generată o excepție.
Problema # 2: Parametrii @ nu au o valoare corespunzătoare în testng.xml.
Puteți rezolva acest lucru adăugând @Adnotare opțională la parametrul corespunzător din metoda de testare.
Problema # 3: Doriți să testați mai multe valori ale aceluiași parametru folosind testng.xml.
Răspunsul simplu este că acest lucru nu se poate face. Puteți avea mai mulți parametri diferiți, dar fiecare parametru poate conține o singură valoare. Acest lucru previne codificarea hardcoding a valorilor în script și menține codul reutilizabil - gândiți-vă la el ca la un fișier de configurare pentru scriptul dvs. Dacă aveți nevoie de mai multe valori pentru un parametru, utilizați în schimb un DataProvider.
Furnizor de date în TestNG
Furnizor de date în TestNG este o metodă utilizată atunci când un utilizator trebuie să transmită parametri complecși. Parametrii complecși trebuie creați din Java — obiecte complexe, obiecte din fișierele de proprietăți sau obiecte dintr-o bază de date pot fi transmise prin metoda furnizorului de date. Metoda este adnotată cu @DataProvider și returnează o matrice de obiecte.
Parametri folosind Dataprovider
Adnotarea @Parameters este simplă, dar pentru a testa cu mai multe seturi de date trebuie să folosim un furnizor de date.
Pentru a completa mii de formulare web folosind framework-ul nostru de testare, avem nevoie de o metodologie diferită, care poate furniza un set de date foarte mare într-un singur flux de execuție.
Acest concept bazat pe date este realizat prin @DataProvider adnotare în TestNG.
Are doar unul atribut, 'nume'Dacă nu specificați atributul name, numele DataProvider este același cu numele metodei corespunzătoare.
Un furnizor de date returnează un bidimensional Java obiect la metoda de testare, iar metoda de testare este invocată de M ori pentru o matrice de obiecte M×N. De exemplu, dacă DataProvider returnează o matrice de 2×3 obiecte, cazul de testare corespunzător este invocat de 2 ori cu 3 parametri de fiecare dată.
Exemplu complet
package parameters; import java.time.Duration; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.testng.Assert; import org.testng.annotations.BeforeTest; import org.testng.annotations.DataProvider; import org.testng.annotations.Test; public class ParameterByDataprovider { WebDriver driver; @BeforeTest public void setup() { // Create the Firefox driver object driver = new FirefoxDriver(); driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); driver.get("https://google.com"); } /** Test case to verify the Google search box */ @Test(dataProvider = "SearchProvider") public void testMethod(String author, String searchKey) throws InterruptedException { WebElement searchText = driver.findElement(By.name("q")); // Search value in the Google search box searchText.sendKeys(searchKey); System.out.println("Welcome ->" + author + " Your search key is->" + searchKey); Thread.sleep(3000); String testValue = searchText.getDomProperty("value"); System.out.println(testValue + "::::" + searchKey); searchText.clear(); // Verify if the value in the Google search box is correct Assert.assertTrue(testValue.equalsIgnoreCase(searchKey)); } /** * @return Object[][] where the first column contains 'author' * and the second column contains 'searchKey' */ @DataProvider(name = "SearchProvider") public Object[][] getDataFromDataprovider() { return new Object[][] { { "Guru99", "India" }, { "Krishna", "UK" }, { "Bhupesh", "USA" } }; } }
Invocați DataProvider din clasă diferită
În mod implicit, un DataProvider se află în aceeași clasă ca metoda de testare sau în clasa sa de bază. Pentru a-l plasa într-o altă clasă, faceți ca metoda furnizorului de date să fie static și adăugați atributul dataProviderClass la @Test adnotare.
Code Exemplu
TestClass ParameterDataproviderWithClassLevel.java
package parameters; import java.time.Duration; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.testng.Assert; import org.testng.annotations.BeforeTest; import org.testng.annotations.Test; public class ParameterDataproviderWithClassLevel { WebDriver driver; @BeforeTest public void setup() { driver = new FirefoxDriver(); driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); driver.get("https://google.com"); } @Test(dataProvider = "SearchProvider", dataProviderClass = DataproviderClass.class) public void testMethod(String author, String searchKey) throws InterruptedException { WebElement searchText = driver.findElement(By.name("q")); // Search text in the Google text box searchText.sendKeys(searchKey); System.out.println("Welcome ->" + author + " Your search key is->" + searchKey); Thread.sleep(3000); // Get text from the search box String testValue = searchText.getDomProperty("value"); System.out.println(testValue + "::::" + searchKey); searchText.clear(); // Verify if the search box has the correct value Assert.assertTrue(testValue.equalsIgnoreCase(searchKey)); } }
DataproviderClass.java
package parameters; import org.testng.annotations.DataProvider; public class DataproviderClass { @DataProvider(name = "SearchProvider") public static Object[][] getDataFromDataprovider() { return new Object[][] { { "Guru99", "India" }, { "Krishna", "UK" }, { "Bhupesh", "USA" } }; } }
Tipuri de parametri în Dataprovider
Există două tipuri de parametri acceptați de metoda DataProvider.
Metodă — dacă acelaşi DataProvider ar trebui să se comporte diferit pentru diferite metode de testare, utilizați parametrul Method.
În exemplul următor:
- Verificăm dacă numele metodei este testMethodA
- Dacă da, returnează un set de valori
- Altfel, returnează un alt set de valori
package parameters; import java.lang.reflect.Method; import java.time.Duration; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.testng.Assert; import org.testng.annotations.BeforeTest; import org.testng.annotations.DataProvider; import org.testng.annotations.Test; public class ParameterByMethodInDataprovider { WebDriver driver; @BeforeTest public void setup() { driver = new FirefoxDriver(); driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); driver.get("https://google.com"); } @Test(dataProvider = "SearchProvider") public void testMethodA(String author, String searchKey) throws InterruptedException { WebElement searchText = driver.findElement(By.name("q")); searchText.sendKeys(searchKey); // Print author and search string System.out.println("Welcome ->" + author + " Your search key is->" + searchKey); Thread.sleep(3000); String testValue = searchText.getDomProperty("value"); System.out.println(testValue + "::::" + searchKey); searchText.clear(); Assert.assertTrue(testValue.equalsIgnoreCase(searchKey)); } @Test(dataProvider = "SearchProvider") public void testMethodB(String searchKey) throws InterruptedException { WebElement searchText = driver.findElement(By.name("q")); searchText.sendKeys(searchKey); // Print only the search string System.out.println("Welcome ->Unknown user Your search key is->" + searchKey); Thread.sleep(3000); String testValue = searchText.getDomProperty("value"); System.out.println(testValue + "::::" + searchKey); searchText.clear(); Assert.assertTrue(testValue.equalsIgnoreCase(searchKey)); } /** The DataProvider returns values based on the test method name */ @DataProvider(name = "SearchProvider") public Object[][] getDataFromDataprovider(Method m) { if (m.getName().equalsIgnoreCase("testMethodA")) { return new Object[][] { { "Guru99", "India" }, { "Krishna", "UK" }, { "Bhupesh", "USA" } }; } else { return new Object[][] { { "Canada" }, { "Russia" }, { "Japan" } }; } } }
Iată rezultatul:
ITestContext — aceasta poate fi utilizată pentru a crea parametri diferiți pentru cazurile de testare bazate pe grupuri.
În viața reală, puteți utiliza ITestContext pentru a varia valorile parametrilor în funcție de metodele de testare, gazdele sau configurațiile de testare.
În următorul exemplu de cod:
- Avem 2 grupe, A și B
- Fiecare metodă de testare este atribuită unui grup
- Dacă valoarea grupului este A, se returnează un set de date
- Dacă valoarea grupului este B, se returnează un alt set de date.
package parameters; import java.time.Duration; import org.openqa.selenium.By; import org.openqa.selenium.WebDriver; import org.openqa.selenium.WebElement; import org.openqa.selenium.firefox.FirefoxDriver; import org.testng.Assert; import org.testng.ITestContext; import org.testng.annotations.BeforeTest; import org.testng.annotations.DataProvider; import org.testng.annotations.Test; public class ParameterByITestContextInDataprovider { WebDriver driver; @BeforeTest(groups = {"A", "B"}) public void setup() { driver = new FirefoxDriver(); driver.manage().timeouts().implicitlyWait(Duration.ofSeconds(10)); driver.get("https://google.com"); } @Test(dataProvider = "SearchProvider", groups = "A") public void testMethodA(String author, String searchKey) throws InterruptedException { WebElement searchText = driver.findElement(By.name("q")); searchText.sendKeys(searchKey); System.out.println("Welcome ->" + author + " Your search key is->" + searchKey); Thread.sleep(3000); String testValue = searchText.getDomProperty("value"); System.out.println(testValue + "::::" + searchKey); searchText.clear(); Assert.assertTrue(testValue.equalsIgnoreCase(searchKey)); } @Test(dataProvider = "SearchProvider", groups = "B") public void testMethodB(String searchKey) throws InterruptedException { WebElement searchText = driver.findElement(By.name("q")); searchText.sendKeys(searchKey); System.out.println("Welcome ->Unknown user Your search key is->" + searchKey); Thread.sleep(3000); String testValue = searchText.getDomProperty("value"); System.out.println(testValue + "::::" + searchKey); searchText.clear(); Assert.assertTrue(testValue.equalsIgnoreCase(searchKey)); } /** The DataProvider supplies an Object array based on ITestContext */ @DataProvider(name = "SearchProvider") public Object[][] getDataFromDataprovider(ITestContext c) { Object[][] groupArray = null; for (String group : c.getIncludedGroups()) { if (group.equalsIgnoreCase("A")) { groupArray = new Object[][] { { "Guru99", "India" }, { "Krishna", "UK" }, { "Bhupesh", "USA" } }; break; } else if (group.equalsIgnoreCase("B")) { groupArray = new Object[][] { { "Canada" }, { "Russia" }, { "Japan" } }; break; } } return groupArray; } }
Notă: Dacă rulați TestNG direct, aceasta apelează mai întâi furnizorul de date, iar furnizorul nu poate citi informațiile despre grup deoarece grupurile nu sunt încă disponibile. Apelarea clasei prin testng.xml face ca informațiile despre grup să fie disponibile prin ITestContext. Folosiți următorul XML pentru a rula testul:
<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd"> <suite name="test-parameter"> <test name="example1"> <groups> <run> <include name="A" /> </run> </groups> <classes> <class name="parameters.ParameterByITestContextInDataprovider" /> </classes> </test> <test name="example2"> <groups> <run> <include name="B" /> </run> </groups> <classes> <class name="parameters.ParameterByITestContextInDataprovider" /> </classes> </test> </suite>
Ambele mecanisme sunt acum acoperite, așa că întrebarea practică este pe care să o alegem.
@Parameters vs @DataProvider: Pe care să îl utilizați
Cele două abordări nu sunt interschimbabile. Decizia se reduce la câte combinații de valori are nevoie un test și de unde provin aceste valori.
| Criteriu | @Parametri + testng.xml | @DataProvider |
|---|---|---|
| Valori per parametru | Exact unul | Rânduri nelimitate |
| Sursă de date | Text static în fișierul XML | Java cod, Excel, CSV, bază de date, API |
| Tipuri acceptate | Valori tipizate din String | Orice Java obiect |
| Invocări de testare | O dată per configurație | O dată pe rând de date |
| Modificarea datelor necesită | Editarea fișierului XML | Editarea sursei, adesea fără recompilare |
| Cel mai potrivit pentru | Valori de mediu și de configurare, cum ar fi browserul, URL, acreditări | Testare bazată pe date pentru mai multe combinații de intrări |
În practică, majoritatea suitelor folosesc ambele: @Parameters transportă setările de mediu care rămân constante pe parcursul unei rulări, iar @DataProvider furnizează datele de business variabile. Când setul de date depășește o matrice hardcoded, următorul pas este citirea acestuia dintr-o foaie de calcul.
Cum se citesc datele de test dintr-un fișier Excel folosind DataProvider
Matricele hardcoded opresc scalarea odată ce testerii care nu scriu Java trebuie să întrețineți datele. Mutarea rândurilor într-o foaie de calcul separă datele de testare de logica de testare, care este forma practică a testare bazată pe dateApache POI citește registrul de lucru, iar DataProvider convertește fiecare rând într-o singură invocare de test.
- Adăugați dependența. Include
org.apache.poi:poi-ooxmlîn Maven-ul tău sau Gradle construi. Theooxmlartefactul gestionează formatul .xlsx; simplupoicitește doar fișierele .xls vechi. - Creați registrul de lucru. Puneți rândul de antet în rândul 0 și câte un caz de testare pe rând sub acesta, cu o coloană pentru fiecare argument al metodei de testare.
- Citește foaia într-o matrice. Dimensionează Obiectul[][] din numărul de rânduri și celule, astfel încât noile rânduri să fie preluate fără modificări de cod.
- Returnați-l de la furnizor. Semnătura metodei de testare rămâne exact ca înainte.
import java.io.FileInputStream; import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.testng.annotations.DataProvider; public class ExcelDataProvider { @DataProvider(name = "SearchProvider") public Object[][] readSearchData() throws Exception { FileInputStream file = new FileInputStream("src/test/resources/testdata.xlsx"); Workbook workbook = new XSSFWorkbook(file); Sheet sheet = workbook.getSheetAt(0); // Skip the header row, so subtract one from the physical row count int rows = sheet.getLastRowNum(); int cols = sheet.getRow(0).getPhysicalNumberOfCells(); Object[][] data = new Object[rows][cols]; for (int i = 1; i <= rows; i++) { for (int j = 0; j < cols; j++) { data[i - 1][j] = sheet.getRow(i).getCell(j).getStringCellValue(); } } workbook.close(); file.close(); return data; } }
💡 Sfat: Apel getStringCellValue() numai pe celulele formatate ca text. O celulă numerică generează IllegalStateException, care este cea mai frecventă eroare atunci când o foaie de calcul conține coduri sau sume. Folosește un DataFormatter pentru a citi fiecare tip de celulă ca șir de caractere sau pentru a activa cell.getCellType() și convertește explicit.
Odată cu externalizarea datelor, adăugarea a încă o sută de cazuri de testare devine o editare a foii de calcul, mai degrabă decât o modificare a codului, iar același furnizor poate alimenta mai multe clase de testare prin intermediul... dataProviderClass atributul arătat anterior.
















