Ši pamoka - tai įvadas į API testavimą naudojant Karate Framework. Sužinokite apie Karate testavimo scenarijaus struktūrą ir pirmojo testavimo scenarijaus kūrimo žingsnius:
API - tai santrumpa, reiškianti taikomųjų programų sąsają. Paprastai ją galime apibrėžti kaip programinės įrangos tarpininką, leidžiantį palaikyti ryšį tarp taikomųjų programų.
API testavimas mums reikalingas, nes:
- Rezultatai skelbiami greičiau, todėl nebereikia laukti, kol bus patikrinta, ar API veikia tinkamai.
- Greičiau reaguojant, šios API diegiamos greičiau, todėl galima greitai atlikti darbus.
- Ankstyvas gedimų nustatymas, dar prieš sukuriant programėlės vartotojo sąsają, leidžia sumažinti riziką ir ištaisyti klaidas.
- Didelės apimties pristatymas galimas per trumpesnį laiką.
Kad galėtume dirbti API testavimo srityje, rinkoje yra įvairių įrankių, pavyzdžiui, Postman, Mocha ir Chai. Šie įrankiai pademonstravo gerus rezultatus ir veiksmingą naudojimą API testavimui, tačiau jie yra labai priklausomi nuo kodo. Kad galėtumėte jais naudotis, turite būti techniškai išprusę ir išmanyti programavimo kalbas.
"Karate Framework" puikiai išsprendžia šią ankstesnių programinės įrangos priemonių problemą.
Kas yra karatė sistema
Karatė? Pakalbėkime apie karatė. Ar tai tas iš Japonijos? Kaip manote? Gali būti, kad didysis Bruce'as Lee jį sukūrė laisvalaikiu.
Nors norėtume pasidomėti įdomiomis karatė šaknimis, kol kas pakalbėkime apie Karatė įrankis kurį sukūrė Peter Thomas , vienas iš puikių įrankių, padedančių API testuotojams.
Karate karkasas atitinka Cucumber programos rašymo stilių, kuriame laikomasi BDD metodo. Sintaksė yra lengvai suprantama ir neprogramuotojams. Ir šis karkasas yra vienintelis API testavimo įrankis, kuris sujungė API automatizavimą ir našumo testavimą į vieną atskirą įrankį.
Naudotojams suteikiama galimybė lygiagrečiai vykdyti testavimo atvejus ir atlikti JSON & amp; XML patikrinimus.
Turint šią informaciją, galima nustatyti tam tikrus pagrindinius dalykus, kurie padės išsamiau suprasti karatė įrankį:
- "Karate" yra ne TDD, o BDD testavimo sistema.
- Ji sukurta taip, kad ją būtų lengva naudoti ir neprogramuotojams. Ši savybė keičia žaidimo taisykles, nes suteikia daugiau galimybių naudoti ir naudotis daugeliui žmonių, neatsižvelgiant į jų techninį pasirengimą ar gebėjimus.
- Testams rašyti naudojama "Cucumber" funkcijų rinkmena ir "Gherkins" kalba, kurią labai lengva suprasti.
Dėl visų šių funkcijų tai yra viena palankiausių šiuo metu prieinamų automatizavimo priemonių.
Karatė istorijos sistema
Sukūrė Peter Thomas' 2017 m., šia programine įranga siekiama, kad testavimo funkcijos būtų lengvai prieinamos visiems. Ji buvo parašyta Java kalba ir dauguma žmonių tikėjosi, kad jos failai taip pat bus ta pačia kalba, tačiau, laimei, taip nėra.
Veikiau ji naudoja Gherkins failus, o tai lemia jos ryšys su Cucumber karkasu. Automatizavimo programinė įranga yra Cucumber plėtinys, todėl paveldi Gherkins failų naudojimą savo veikloje. Didelis skirtumas tarp jų yra tas, kad Karate testuojant nenaudoja Java, o Cucumber naudoja.
Būtent dėl šios priežasties ji skirta ne programuotojams, nes Gherkins sintaksė yra itin lengvai skaitoma ir išsami. Būtent dėl šios priežasties "Karate" yra tinkamiausia ir labiausiai rekomenduojama norint patekti į automatizuoto API testavimo pasaulį.
Toliau pateikiamos kai kurios "Karate Testing Framework" funkcijos:
- Naudojama lengvai suprantama "Gherkins" kalba.
- Jai nereikia techninių programavimo žinių, kaip "Java".
- Jis pagrįstas populiariais "Cucumber" standartais.
- Lengva sukurti sistemą.
- Lygiagretusis testavimas yra pagrindinė funkcija, kurią užtikrina pati "Karate", todėl mums nereikia priklausyti nuo "Maven", "Gradle ir t. t.
- Naudotojo sąsaja, skirta testo derinimui.
- Funkcijų failo iškvietimas iš kito failo.
- Suteikiama duomenų tvarkyklės testavimo, kuris yra sukurtas pačioje įmonėje, parama, todėl nereikia priklausyti nuo išorinių struktūrų.
- Integruotos vietinės poilsio ataskaitos. Be to, ją galima integruoti su "Cucumber", kad būtų geresnės vartotojo sąsajos ataskaitos ir daugiau aiškumo.
- Teikia vidinę pagalbą perjungiant konfigūraciją skirtingose testavimo aplinkose (QA, Stage, Prod, Pre-Prod).
- Sklandus CI/CD integracijos palaikymas, kuris gali būti naudingas.
- Gali apdoroti įvairius HTTP skambučius:
- "Web Socket" palaikymas
- SOAP užklausa
- HTTP
- Naršyklės slapukų tvarkymas
- HTTPS
- HTML formos duomenys
- XML užklausa
Karatė ir "Rest-Assured" palyginimas
Užtikrintas poilsis : Tai Java pagrindu sukurta biblioteka, skirta REST paslaugoms testuoti. Kodo eilutėms rašyti ji naudoja Java kalbą. Ji padeda testuoti daugybę užklausų kategorijų, todėl toliau tikrinami įvairūs verslo logikos deriniai.
Karatė sistema : Cucumber/Gherkins pagrindu sukurta priemonė, naudojama SOAP ir REST paslaugoms testuoti.
Toliau pateiktoje lentelėje išvardyti keli ryškesni skirtumai tarp "Rest-Assured & amp; Karate Framework":
| S.Nr. | Pagrindas | Karatė sistema | Užtikrintas REST |
|---|---|---|---|
| 1 | Kalba | Jame naudojamas agurkų ir agurkėlių derinys | Jame naudojama "Java" kalba |
| 2 | Kodas Dydis | Paprastai kodo eilučių yra mažiau, nes jos atitinka "Cucumber" struktūrą. | Kodo eilučių yra daugiau, nes naudojama "Java" kalba. |
| 3 | Reikalingos techninės žinios | Ne programuotojai gali lengvai parašyti "Gherkins" kodą | Reikalingos techninės žinios, kad galėtumėte rašyti "Java" kodą |
| 4 | Į duomenis orientuotas testavimas | Reikia naudoti TestNG arba lygiavertę sistemą, kad būtų galima palaikyti tą patį | Duomenų testavimui galima naudoti vidines žymas |
| 5 | Ar palaiko SOAP skambučius | Taip, ji suteikia | Tai susiję tik su REST užklausa |
| 6 | Lygiagretus testavimas | Taip, lygiagretus testavimas lengvai palaikomas ir naudojant lygiagretų ataskaitų generavimą | Nors žmonės bandė tai daryti, nesėkmių skaičius yra didesnis nei sėkmės. |
| 7 | Pranešimų teikimas | Jis teikia vidines ataskaitas, todėl nereikia priklausyti nuo išorinių įskiepių. Galime netgi integruoti jį su "Cucumber" ataskaitų įskiepiu, kad vartotojo sąsaja būtų geresnė. | Reikia priklausyti nuo išorinių įskiepių, tokių kaip Junit, TestNG |
| 8 | CSV išorinių duomenų palaikymas | Taip, iš Karate 0.9.0 | Ne, reikia naudoti "Java" kodą arba biblioteką |
| 9 | Web sąsajos automatizavimas | Taip, nuo Karate 0.9.5 Web-UI automatizavimas yra įmanomas | Ne, jis nepalaikomas |
| 10 | GET pavyzdys | Duota param val1 = 'name1' | given(). |
Taigi, kaip matyti iš pirmiau pateiktų skirtumų, galima drąsiai teigti, kad karatė yra vienas lengviausių dalykų, kuriuos gali daryti kiekvienas.
Įrankiai, reikalingi darbui su karatė sistema
Dabar, kai jau turime pagrindines žinias apie "Karate" sistemą, apžvelkime procesus ir įrankius, reikalingus "Karate" aplinkai sukurti.
#1) Užtemimas
Eclipse yra integruota kūrimo aplinka, naudojama kompiuterių programavimo srityje. Dažniausiai ji naudojama Java programavimui. Kaip minėta anksčiau, "Karate" parašyta Java kalba, todėl logiškiau, kodėl Eclipse yra IDE, skirta API testavimo programinei įrangai. Kita priežastis yra ta, kad tai atvirojo kodo įrankis, o tai gana svari priežastis rinktis šį įrankį.
Pastaba: Galime naudoti "IntelliJ", "Visual Studio" ir kitus rinkoje esančius redaktorius.
#2) "Maven
Tai kūrimo automatizavimo priemonė, daugiausia naudojama "Java" projektams kurti. Tai vienas iš būdų sukurti "Karate" aplinką ir rašyti kodą. Norėdami nustatyti "Eclipse" su "Maven" reikalavimais, galite spustelėti šią nuorodą, kad įdiegtumėte "Maven".
Dirbdami su "Maven", naudokite "Maven" priklausomybes, kurios padėtų palaikyti "Karate Framework".
Kartu su "Maven" pom.xml bus naudojamos šios priklausomybės.
com.intuit.karate karate-apache 0.9.5 test com.intuit.karate karate-junit4 0.9.5 test
Pastaba: Naujausios versijos gali būti prieinamos "Maven" saugykloje.
#3) Gradle
Gradle yra Maven alternatyva ir gali būti naudojama lygiaverčiai. Jie turi panašumų ir skirtumų, tačiau gali būti vienodai naudojami kuriant aplinką mūsų Karate kodams.
Ją lengviau naudoti, ji yra lanksti ir rekomenduojama naudoti, kai mūsų programai keliami tam tikri moduliavimo ir valdymo reikalavimai, kai yra daug įskiepių. "Gradle" sąrankos kodas atrodytų maždaug taip,
testCompile 'com.intuit.karate:karate-junit4:0.6.0' testCompile 'com.intuit.karate:karate-apache:0.6.0'
Pastaba: Galite naudoti MAVEN arba GRADLE.
#4) "Java" aplinkos nustatymas jūsų sistemoje
Reikia nustatyti JDK ir JRE aplinką, kad galėtumėte pradėti naudoti "Karate Framework" scenarijus.
Karatė testo scenarijaus struktūra
Karate testo scenarijus žinomas dėl plėtinio ".feature" turėjimo. Ši savybė yra paveldėta iš Cucumber. Taip pat lygiai taip pat leidžiama organizuoti failus pagal Java konvencijas. Galite laisvai organizuoti savo failus pagal Java paketų konvencijas.
Tačiau "Maven" gairėse nurodoma, kad ne "Java" failus reikia saugoti atskirai. Jie saugomi src/test/resources struktūrą. O Java failai saugomi src/main/java .
Tačiau, kaip teigia "Karate Framework" kūrėjai, jie tvirtai tiki, kad "Java" ir ne "Java" failus turėtume laikyti greta. Jų teigimu, daug lengviau ieškoti *.java ir *.feature failų, kai jie laikomi kartu, o ne pagal standartinę "Maven" struktūrą.
Tai galima lengvai padaryti, pakeitus pom.xml taip (Maven atveju):
src/test/java **/*.java ...
Toliau pateikiama bendra karatė sistemos struktūra:
Kadangi šioje Karate Framework sistemoje naudojamas Runner failas, kuris taip pat reikalingas Cucumber sistemoje, kad būtų galima paleisti funkcijų failus, todėl didžioji dalis teksto bus parašyta pagal Cucumber standartus.
Tačiau, kitaip nei "Cucumber", "Karate" žingsniai nereikalauja aiškaus apibrėžimo, o tai savo ruožtu padidina lankstumą ir palengvina operacijas. Mums nereikia pridėti papildomų klijų, kuriuos paprastai tenka pridėti, kai vadovaujamės "Cucumber" sistema.
"Runner" klasė dažniausiai pavadinama TestRunner.java.
Tada TestRunner.java failas bus tokios formos:
import com.intuit.karate.junit4.Karate; import org.junit.runner.RunWith; @RunWith(Karate.class) public class TestRunner { } Ir kalbėdami apie .feature faile pateikiami visi testavimo scenarijai, kuriuos reikia išbandyti, norint įsitikinti, kad API veikia pagal numatytus reikalavimus.
Bendras *.feature failas atrodo taip, kaip parodyta toliau:
Funkcija: naudotojo duomenų gavimas Scenarijus: naudotojo duomenų gavimo skambučio testavimas Duotas url '//reqres.in/api/users/2' Kai metodas GET Tada būsena 200
Pirmojo pagrindinio karatė testo scenarijaus sukūrimas
Šis skyrius padės jums pradėti kurti pirmąjį testavimo scenarijų, kuris jums bus naudingas konvertuojant API į Karate sistemą.
Prieš rašydami pagrindinius "Karate" testų scenarijus, į savo kompiuterį įdiekite šiuos rekvizitus:
- "Eclipse" IDE
- Maven. Nustatykite atitinkamą "Maven" kelią.
- JDK & JRE. Nustatykite atitinkamą kelią.
Pažvelkime į šį metodą žingsnis po žingsnio:
#1) Sukurti naują MAVEN Projektas "Eclipse" redaktoriuje
- Atviras "Eclipse
- Spustelėkite File (failas). Pasirinkite New Project (naujas projektas).
- Pasirinkite "Maven" projektą
- Pasirinkite darbo vietos vietą.
- Pasirinkite archetipą (paprastai pasirenkame " Maven-archetype-quickstart 1.1 " paprastiems "Maven" projektams).
- Nurodykite grupės ID & amp; artefakto ID (savo pavyzdyje naudojome šias vertes).
- Grupės ID : karatė
- Artefakto ID: KarateTestScriptsSample
- Spustelėkite Baigti, kad baigtumėte sąranką.
#2) Sukūrę projektą, dabar "Project Explorer" lange matysite tokią struktūrą.
#3) Įtraukite visas priklausomybes.
Mūsų pirmasis žingsnis po sąrankos bus įtraukti visas priklausomybes kurios bus reikalingos vykdymui. Visas žymas laikysime POM.xml (darant prielaidą, kad jau žinote apie POM.xml naudojimą).
- Atidarykite POM.xml, nukopijuokite toliau pateiktą kodą po priklausomybės žyma ir išsaugokite failą.
com.intuit.karate karate-apache 0.9.5 test com.intuit.karate karate-junit4 0.9.5 test
Spauskite čia, jei norite rasti šaltinį.
#4) Apžvelkime scenarijų, ką ketiname išbandyti šiame karatė pagrindiniame testo scenarijuje.
Scenarijus:
Naudodami šį URL testuosime API.
Kelias: api/users/2
Metodas: GET
Ir mes turime patvirtinti , ar užklausa grąžina Sėkmės kodas (200) arba ne.
Paprasčiau tariant, mes tiesiog išbandysime pavyzdinę API ir patikrinsime, ar ji sėkmingai vykdoma.
Pastaba: Mes naudojame API pavyzdį, kurį galima išbandyti. Galite pasirinkti bet kurį PATH arba nurodyti savo API.
Spauskite čia, jei norite rasti šaltinį.
#5) Kitas mūsų žingsnis būtų sukurti .feature failas.
Kaip aptarta įžanginiame skyriuje. .feature failas yra savybė, paveldėta iš Cucumber'io. Šiame faile įrašysime testavimo scenarijus, kuriuos reikia atlikti atliekant API testavimą.
- Eiti į aplanką src/test/java savo projekte.
- Dešiniuoju pelės mygtuku spustelėkite ant jo ir sukurkite naują failą - userDetails.feature. Tada spustelėkite mygtuką Baigti.
Dabar aplanke matysite šį failą src/test/java
Svetainė Žalios spalvos piktograma primena .feature fi le Cucumber programoje, kurią ką tik sukūrėme.
- Sukūrę failą, dabar rašysime bandymų scenarijus, kurie bus aptarti kitame skyriuje.
#6) Kadangi turime scenarijų ir tuščią . funkcija failas paruoštas, dabar pradėkime savo pirmąjį scenarijų. Pradėkime koduoti
Įrašykite šią kodo eilutę į userDetails.feature failą, kurį sukūrėme 5 žingsnyje:
Funkcija: naudotojo duomenų gavimas Scenarijus: naudotojo duomenų gavimo skambučio testavimas Duotas url '//reqres.in/api/users/2' Kai metodas GET Tada būsena 200
Pabandykime suprasti pirmiau pateiktame faile įrašytus komponentus:
- Funkcija: Raktinis žodis paaiškina testuojamos funkcijos pavadinimą.
- Pagrindinės aplinkybės: Tai neprivalomas skirsnis, kuris traktuojamas kaip išankstinių sąlygų skirsnis. Jame galima apibrėžti, ko reikia norint išbandyti API. Jame yra HEADER, URL & amp; PARAM galimybės.
- Scenarijus: Kiekviename funkcijų faile, kurį matysite, bus bent viena funkcija (nors ji gali suteikti kelios scenarijus). Tai yra testavimo atvejo aprašymas.
- Atsižvelgiant į tai, kad: Tai veiksmas, kuris turi būti atliktas prieš atliekant bet kurį kitą testavimo veiksmą. Tai privalomas atlikti veiksmas.
- Kada: Jame nurodoma sąlyga, kuri turi būti įvykdyta, kad būtų galima atlikti kitą bandymo etapą.
- Tada: Jame nurodoma, kas turėtų atsitikti, jei sąlyga, nurodyta Kai yra patenkintas.
Pastaba: Visi minėti raktiniai žodžiai yra iš Gherkins kalbos. Tai yra standartinis testų scenarijų rašymo būdas naudojant Cucumber.
Ir dar keletas žodžių, vartojamų funkcijų faile:
- 200: Tai būsenos/atsakymo kodas, kurio laukiame (būsenos kodų sąrašą rasite čia).
- GET: Tai API metodas, pavyzdžiui, POST, PUT ir t. t.
Tikimės, kad šį paaiškinimą jums buvo lengva suprasti. Dabar galėsite susieti, kas tiksliai parašyta pirmiau pateiktame faile.
Dabar reikia sukurti TestRunner.java failą
Kaip paaiškinta ankstesniame skyriuje, "Cucumber" reikia "Runner" failo, kuris būtų reikalingas vykdyti .feature failą, kuriame pateikiami testavimo scenarijai.
- Eiti į aplanką src/test/java savo projekte
- Dešiniuoju pelės mygtuku spustelėkite jį ir sukurkite naują "Java" failą: TestRunner.java
- Sukūrus failą, po juo įterpkite šias kodo eilutes:
import org.junit.runner.RunWith; import com.intuit.karate.junit4.Karate; @RunWith(Karate.class) public class TestRunner { } - Test Runner - tai failas, kuris dabar bus vykdomas norint atlikti norimą scenarijų, parašytą 5 žingsnyje.
#7) Dabar turime abu failus TestRunner.Java ir userDeatils.feature. Vienintelė mums likusi užduotis - Paleisti scenarijų.
- Eikite į TestRunner.java failą ir dešiniuoju pelės klavišu spustelėkite failą, kaip parodyta toliau pateiktame paveikslėlyje.
- Pasirinkite Paleisti kaip -> Junit testas
- Pasirinkę pradėsite pastebėti, kad bandomasis atvejis jau pradėtas.
- Palaukite, kol testo scenarijus bus įvykdytas. Kai tai bus padaryta, savo lange pamatysite kažką panašaus į tai, kas parodyta toliau pateiktame paveikslėlyje.
- Galiausiai galime teigti, kad sėkmingai sukūrėme pirmąjį pagrindinį Bandymo scenarijus naudojant Karatė sistema.
#8) Galiausiai "Karate" sistema taip pat pateikia atlikto vykdymo HTML ataskaitą.
- Eikite į tikslinį aplanką -> surefire-reports-> Čia pamatysite savo HTML ataskaitą, kurią galėsite atidaryti.
** Taip pat siūlome atidaryti tą patį puslapį "Chrome" naršyklėje, kad jis atrodytų geriau.
- Jums bus parodyta ši HTML ataskaita, kurioje pavaizduota Scenarijai & amp; Testas kuris buvo įvykdytas pagal minėtą scenarijų:
Išvada
Šioje pamokoje aptarėme API testavimą, įvairius rinkoje esančius testavimo įrankius ir tai, kad "Karate Framework" yra geresnis variantas, palyginti su kitomis programomis.
Pirmąjį pagrindinį testo scenarijų sukūrėme žingsnis po žingsnio. Pradėjome nuo to, kad sukūrėme pagrindinį "Maven" projektas "Eclipse IDE" aplinkoje sukurti .feature failą, kuriame būtų visi testavimo scenarijai, ir Runner failą, skirtą .feature faile nurodytam testavimo atvejui atlikti.
Kelių etapų pabaigoje galime pamatyti testo rezultatų vykdymo ataskaitą.
Tikimės, kad ši pamoka buvo naudinga pradedantiesiems, norintiems sužinoti, kaip sukurti pirmąjį testavimo scenarijų naudojant Karate Framework ir atlikti API testavimą. Šis išsamus žingsnis po žingsnio metodas yra puikus būdas paleisti ir atlikti įvairius API testus.
KITAS>>