Dit tutorial is in ynlieding foar API-testen mei Karate Framework. Learje oer de struktuer fan Karate Test Script en stappen om it earste testskript te bouwen:
API is in akronym dat stiet foar Application Programming Interface. Yn ienfâldige termen kinne wy it definiearje as in software tuskenpersoan dy't kommunikaasje mooglik makket tusken applikaasjes.
Wy hawwe API-testen nedich omdat:
- Resultaten wurde rapper publisearre, dus net mear wachtsje om te sjen oft de API goed wurket.
- Mei de fluggere reaksje wurdt de ynset fan dizze API's ek flugger, dus makket it mooglik foar rappe omslachtiid.
- Early failure detection, sels foardat de UI fan 'e app is oanmakke, lit ús risiko's ferminderje en fouten korrizjearje.
- Grutskalige levering mooglik yn in koartere perioade.
Om te kinnen wurkje oan API-testen, hawwe wy ferskate ark beskikber op 'e merke lykas Postman, Mocha, en Chai. Dizze hawwe goede resultaten en effektyf gebrûk oantoand foar testen fan API's, lykwols binne dizze swier beynfloede troch koade. Om dizze te brûken, moat men technysk goed en fertroud wêze mei programmeartalen.
It Karate Framework lost dit probleem fan syn foargeande software-ark prachtich op.
Wat is Karate Framework
Karate? Litte wy Karate prate. Is it dejinge út Japan? Wat tinkt jo? Miskien is dat de grutte Brucedit Karate Basic Test Script.
Senario:
Wy sille in API testen mei dizze URL.
Pad: api/users/2
Metoade: GET
En wy moatte falidearje , oft it fersyk in Sukseskoade werombringt ( 200) of net.
Yn ienfâldige termen sille wy gewoan in foarbyld-API testen om te sjen oft it mei súkses útfierd wurdt.
Opmerking: Wy nimme in stekproef API dy't beskikber is foar testen. Jo kinne elke PATH kieze of kinne ferwize nei jo API.
Klik hjir foar boarne.
#5) No soe ús folgjende stap wêze om in te meitsjen .feature -bestân.
Lykas besprutsen yn 'e ynlieding, is it .feature-bestân it eigendom dat fan Cucumber erfd is. Yn dit bestân sille wy de testsenario's útskriuwe dy't moatte wurde útfierd foar it útfieren fan de API-testen.
- Gean nei map src/test/java yn jo projekt.
- Rjochtsklik derop en meitsje in nij bestân - userDetails.feature. Klik dan op de knop Finish.
No sille jo de folgjende triem sjen ûnder de map src/test/java
It Griene kleurde ikoan liket op de .feature fi le yn Cucumber dy't wy krekt makke hawwe.
- Ienris de triem is oanmakke, no sille wy ús testsenario's skriuwe dy't yn 'e folgjende paragraaf besprutsen wurde.
#6) Sûnt wy hawwe it senario enit lege . funksje -bestân klear, litte wy no begjinne mei ús earste skript. Lit ús begjinne te kodearjen
Skriuw de folgjende rigel fan Code ûnder userDetails.feature-bestân dat wy makke hawwe yn stap #5:
Feature: fetching User Details Scenario: testing the get call for User Details Given url '//reqres.in/api/users/2' When method GET Then status 200
Lit ús besykje te begripen de komponinten dy't skreaun binne yn it boppesteande bestân:
- Funksje: Kaaiwurd ferklearret de namme fan de funksje dy't wy testen.
- Eftergrûn: Dit is in opsjonele seksje dy't wurdt behannele as in foarôfgeande seksje. Dit kin brûkt wurde om te definiearjen wat alles nedich is om de API te testen. It befettet HEADER, URL & amp; PARAM -opsjes.
- Senario: Elk funksjebestân dat jo sille sjen sil op syn minst ien funksje hawwe (hoewol't it meardere senario's kin jaan) . It is de beskriuwing fan it testgefal.
- Joan: It is de stap dy't útfierd wurde moat foardat in oare teststap útfierd wurdt. It is in ferplichte aksje om út te fieren.
- Wannear: It spesifiseart de betingst dêr't foldien wurde moat om de folgjende teststap út te fieren.
- Dan: It fertelt ús dat wat der barre moat yn gefal de betingst neamd yn de As is tefreden.
Opmerking: Alle boppeneamde kaaiwurden binne út de Gherkins taal. Dit binne de standert manier om de test skripts te skriuwen mei Cucumber.
En wat mear wurden brûkt yn it feature triem binne:
- 200: It is de status/antwurdkoade dy't wy binneferwachtet (Klik hjir foar de list mei statuskoades)
- GET: It is de API-metoade lykas POST, PUT, ensfh.
Wy hoopje dizze útlis wie maklik foar jo te begripen. No sille jo kinne relatearje oan wat der krekt yn it boppesteande bestân skreaun is.
No moatte wy in TestRunner.java-bestân oanmeitsje
Lykas hjirboppe útlein seksje, Cucumber hat in Runner-bestân nedich dy't nedich wêze soe om it .feature -bestân út te fieren dat de testsenario's befettet.
- Gean nei map src/test/java yn jo projekt
- Rjochtsklik derop en meitsje in Nij Java-bestân: TestRunner.java
- Sadree't de triem is oanmakke, set de folgjende rigels koade derûnder:
import org.junit.runner.RunWith; import com.intuit.karate.junit4.Karate; @RunWith(Karate.class) public class TestRunner { }- Test Runner is it bestân dat no sil wurde útfierd om de winske senario dat skreaun is ûnder stap #5.
#7) No binne wy klear mei sawol de triemmen TestRunner.Java as userDeatils.feature. De iennichste taak dy't foar ús oerbleaun is is om It skript út te fieren.
- Gean nei TestRunner.java-bestân en Rjochtsklik op it bestân lykas werjûn yn de ûndersteande ôfbylding.
- Kies Run As -> Junit Test
- No, ienris selekteare, sille jo begjinne te observearjen dat de testsaak no begon is.
- Wachtsje oant it testskript wurdt útfierd. Sadree't jo klear binne, sille jo wat observearje lykas werjûn yn 'e ôfbylding hjirûnder yn jo finster.
- Uteinlik kinne wy sizzedat wy ús alderearste basis Testskript mei súkses hawwe makke mei it Karate Framework.
#8) As lêste, de Karate ramt jout ek in HTML-rapportpresintaasje foar de útfiering dy't útfierd is.
- Gean nei Doelmap -> surefire-rapporten- & GT; Hjir sille jo jo HTML-rapport sjen dat jo iepenje kinne.
** Wy soene jo ek foarstelle om itselde te iepenjen mei de Chrome Blêder foar in better uterlik en gefoel.
- Folgjende HTML-rapport sil jo toand wurde mei Senario's en amp; Test dat is útfierd foar it neamde senario:
Konklúzje
Yn dizze tutorial hawwe wy API-testen besprutsen, ferskate testen ark beskikber yn 'e merk, en hoe't it Karate Framework in bettere opsje is yn ferliking mei syn tsjinhingers.
Wy folgen in stap-foar-stap oanpak om ús earste basistestskript te meitsjen. Wy binne begûn mei it meitsjen fan in basis Maven-projekt yn Eclipse IDE om in .feature-bestân te meitsjen, dy't alle testsenario en in Runner-bestân befettet om it testgefal út te fieren neamd yn 'e .feature-bestân.
Oan 'e ein fan' e meardere stappen koenen wy it útfieringsrapport fan 'e testresultaten sjen.
Wy hoopje, dizze tutorial wie nuttich foar de begjinners by it learen hoe't se har earste testskript bouwe mei it Karate Framework en API-testen útfiere. Dit detaillearre stap foar stapoanpak is in prachtige manier om ferskate testen op de API út te fieren en út te fieren.
NEXT>>
Lee hie dit ûntwikkele yn syn frije tiid.Hoewol't wy graach yngean wolle yn 'e nijsgjirrige woartels fan Karate, litte wy no prate oer it Karate-ark dat is ûntwikkele troch Peter Thomas , ien fan 'e grutte ark dy't komme ta de rêding fan API-testers.
Karate-ramt folget de Cucumber-styl fan it skriuwen fan it programma dat de BDD-oanpak folget. De syntaksis is maklik te begripen troch net-programmeurs. En dit ramt is de ienige API test ark dat hat kombinearre API Automatisearring en prestaasjes testen yn in inkele standalone ark.
It jout de brûkers mei de mooglikheid om te fieren de test gefallen yn Parallel en útfiere de JSON & amp; XML-kontrôles.
Mei dizze ynformaasje kinne bepaalde kaaipunten ôflaat wurde om it Karate-ark yn detail fierder te begripen:
- Karate is ynstee in BDD-testkader fan in TDD.
- It is ûntwurpen om maklik te wêzen foar net-programmeurs. Dizze funksje is in spultsje-wikseler, om't it mear gebrûk en tagong makket foar in protte minsken, nettsjinsteande har technyske eftergrûn of kapasiteit.
- It makket gebrûk fan it Cucumber-funksjebestân en de Gherkins-taal om de test te skriuwen dy't is hiel maklik te begripen.
Al dizze funksjes meitsje it ien fan 'e meast geunstige automatisearringsynstruminten dy't hjoed beskikber binne.
History Of Karate Framework
Created by ' Peter Thomas' yn 2017, dizze software is fan doel om testen te meitsjenfunksjonaliteiten maklik beskikber foar elkenien. It is skreaun yn Java en de measte minsken ferwachte dat de triemmen ek yn deselde taal wiene, lykwols, gelokkich, dat is net it gefal.
It brûkt leaver Gherkins-bestannen, wat in gefolch is fan syn relaasje mei de Komkommer ramt. De automatisearring software is in útwreiding fan Cucumber, dêrom erft it gebrûk fan Gherkins triem yn syn operaasje. It grutte ferskil tusken de twa is dat Karate gjin gebrûk makket fan Java by it testen, mar Cucumber docht.
Dit is de reden wêrom't it rjochtet op net-programmeurs, om't de Gherkins-syntaksis super lêsber en wiidweidich is. Dit is de reden dat Karate it meast geskikt is en oanrikkemandearre is foar it meitsjen fan in yngong yn 'e wrâld fan automatisearre API-testen.
De folgjende binne guon funksjes fan it Karate Testing Framework:
- Maakt gebrûk fan maklik te begripen Gherkins-taal.
- It fereasket gjin technyske programmearkennis lykas Java.
- It is basearre op de populêre komkommer-standerts.
- Maklik om in ramt te meitsjen.
- Parallelle testen is de kearnfunksjonaliteit dy't wurdt levere troch de Karate sels, dêrom hoege wy net ôfhinklik fan Maven, Gradle , ensfh.
- UI foar it debuggen fan de Test.
- In funksje-bestân út in oar bestân oproppe.
- Biedt stipe foar de Data Driver Testing dy't yn eigen hûs boud is, dus net nedich om ôfhinklik te wêzen fan eksterne kaders.
- Ynboude Native RestFerslaggen. Plus, it kin yntegrearre wurde mei de komkommer foar bettere UI-rapporten en mear dúdlikens.
- Biedt yn-hûs stipe foar it wikseljen fan konfiguraasje oer ferskate testomjouwings (QA, Stage, Prod, Pre-Prod).
- Naadleaze stipe foar CI/CD-yntegraasje dy't nuttich kin wêze.
- Bêst om ferskate HTTP-oproppen te behanneljen:
- Web Socket-stipe
- SOAP-fersyk
- HTTP
- Browser-cookie-behanneling
- HTTPS
- HTML-formuliergegevens
- XML-fersyk
Fergelykje Karate vs Rest-Assured
Rest Assured : It is in Java-basearre bibleteek om de REST-tsjinsten te testen. It brûkt Java-taal foar it skriuwen fan de rigels fan koade. It helpt by it testen fan ferskate fersykskategoryen, dy't fierder resultearje yn 'e ferifikaasje fan ferskate kombinaasjes fan saaklike logika.
Karate Framework : A komkommer / Gherkins basearre ark, brûkt foar testen foar SOAP & amp; REST tsjinsten.
De folgjende tabel enlists in pear mear promininte ferskillen tusken Rest-Assured & amp; Karate Framework:
| S.No | Basis | Karate Framework | REST-Assured |
|---|---|---|---|
| 1 | Taal | It brûkt in kombinaasje fan komkommer en gherkins | It makket gebrûk fan Java-taal |
| 2 | Koadegrutte | Meastentiids is de line fan koade is minder, om't it komkommer-like struktuer folget | Rin fan koade is mear, om't it degebrûk fan Java-taal |
| 3 | Technyske kennis fereaske | Net-programmeurs kinne maklik skriuwe de Gherkins-koade | Technyske kennis is nedich om Java-koade te skriuwen |
| 4 | Data-oandreaune testen | Moatte gebrûk meitsje fan TestNG of lykweardich om itselde te stypjen | In-house tags kinne brûkt wurde om gegevenstesten te stypjen |
| 5 | Biedt it SOAP-opropstipe | Ja, it jout | It is allinich relatearre oan in REST-fersyk |
| 6 | Parallel testen | Ja, parallelle testen wurdt maklik stipe mei de generaasje fan parallelle rapportaazjes ek | Net foar in grut part. Hoewol minsken hawwe besocht dit te dwaan, is it mislearringsnivo mear dan it súksespersintaazje |
| 7 | Rapportearje | It leveret ynterne rapportaazje, dus hoecht net ôfhinklik te wêzen fan eksterne plugins. Wy kinne it sels yntegrearje mei Cucumber reporting plugin foar bettere UI. | Moatte ôfhinklik wêze fan eksterne plugins lykas Junit, TestNG |
| 8 | CSV-stipe foar eksterne gegevens | Ja, fan Karate 0.9.0 | Nee, moatte Java-koade of biblioteek brûke |
| 9 | Web UI-automatisearring | Ja, fan Karate 0.9.5 Web-UI-automatisearring is mooglik | Nee, it wurdt net stipe |
| 10 | Sample GET | Given param val1 = ‘name1’
| given().
|
Dêrtroch, lykas oantoand troch de ferskillen hjirboppe, it is feilich om te sizzen dat Karate is ien fan de maklikste dingen dy't elkenien kin dwaan.
Tools nedich foar wurkjen mei Karate Framework
No, sûnt wy hawwe krigen ús basis kennis oer Karate Framework op punt, lit ús sjen nei de prosessen en ark nedich by it opsetten fan de Karate omjouwing.
#1) Eclipse
Eclipse is in yntegreare ûntwikkelingsomjouwing brûkt op it mêd fan kompjûterprogrammearring. It wurdt meast brûkt foar Java-programmearring. Lykas earder neamd, is Karate skreaun yn Java, dus it makket mear sin wêrom Eclipse de go-to IDE is foar de API-testsoftware. In oare reden is dat it in iepen boarne ark is, en dit is in frij sterke reden om te kiezen foar dit ark.
Opmerking: Wy koene sels IntelliJ, Visual Studio, en oare ferskillende brûke editors beskikber yn 'e merk.
#2) Maven
Dit is in build-automatisearring-ark dat benammen brûkt wurdt foar it bouwen fan Java-projekten. It is ien manier om in Karate-omjouwing yn te stellen en de koade te skriuwen. Om jo Eclipse mei Maven-easken yn te stellen, kinne jo hjir klikke foar Maven-ynstallaasje.
Wylst jo yn Maven wurkje, brûk Maven-ôfhinklikens dy't jo helpe om Karate Framework te stypjen.
De folgjende ôfhinklikens sille brûkt wurde mei Maven yn pom.xml.
com.intuit.karate karate-apache 0.9.5 test com.intuit.karate karate-junit4 0.9.5 test
Opmerking: De lêste ferzjes kinne miskienbeskikber wêze yn it Maven repository.
#3) Gradle
Gradle is in alternatyf foar Maven en kin brûkt wurde yn gelikense kapasiteit. Se hawwe har oerienkomsten en ferskillen, mar kinne likegoed brûkt wurde by it opsetten fan in omjouwing foar ús Karate-koades.
It is makliker te brûken, fleksibel, en wurdt oanrikkemandearre om te brûken as ús applikaasje wat modularisaasje- en beheareasken hat mei in stel plug-ins. De Gradle-ynstellingskoade soe der sa útsjen,
testCompile 'com.intuit.karate:karate-junit4:0.6.0' testCompile 'com.intuit.karate:karate-apache:0.6.0'
Opmerking: Jo kinne MAVEN of GRADLE brûke.
#4) Java-omjouwing opset yn jo systeem
Moatte de JDK- en JRE-omjouwing ynstelle om te begjinnen mei de Karate Framework-skripts.
Struktuer fan Karate-testskript
In Karate-testskript is bekend om it besit fan de ".feature"-útwreiding. Dit pân is erfd fan komkommer. De organisaasje fan bestannen yn Java-konvinsje is ek likegoed tastien. Jo binne frij om jo bestannen te organisearjen neffens de Java-pakketkonvinsjes.
De Maven-rjochtlinen jouwe lykwols oan dat de opslach fan net-Java-bestannen apart dien wurdt. Se wurde dien yn in src/test/resources -struktuer. En de Java-bestannen wurde bewarre ûnder src/main/java .
Mar neffens de makkers fan it Karate Framework leauwe se sterk dat wy sawol Java- as net-Java-bestannen njonken hâlde side. As per harren, it is folle makliker om te sjen út foar de*.java- en *.feature-bestannen as se byinoar hâlden wurde, ynstee fan de standert Maven-struktuer te folgjen.
Dit kin maklik dien wurde troch jo pom.xml sa oan te passen (Foar Maven):
src/test/java **/*.java ...
Hjirnei is de skets fan 'e algemiene struktuer fan Karate Framework:
No, sûnt dit Karate Framework brûkt de Runner-bestân, dy't ek nedich is yn Cucumber om de funksje-bestannen út te fieren, dus it measte fan it skriuwen sil de Cucumber-noarmen folgje.
Mar, yn tsjinstelling ta Cucumber, hawwe de stappen gjin dúdlike definysje yn Karate nedich en hokker , op syn beurt, ferbetterje fleksibiliteit en gemak fan operaasjes. Wy hoege net de ekstra lym ta te foegjen dy't wy normaal tafoegje moatte as wy it komkommerkader folgje.
De klasse "Runner" wurdt meastentiids TestRunner.java neamd.
Dan sil it TestRunner.java-bestân de foarm oannimme fan:
import com.intuit.karate.junit4.Karate; import org.junit.runner.RunWith; @RunWith(Karate.class) public class TestRunner { }En praat oer it .feature -bestân, it befettet alle testen senario's dy't hifke wurde moatte om der wis fan te wêzen dat de API wurket neffens de ferwachte easken.
In algemien *.feature-bestân sjocht der sa út as hjirûnder werjûn:
Feature: fetching User Details Scenario: testing the get call for User Details Given url '//reqres.in/api/users/2' When method GET Then status 200
It earste basiskaratetestskript oanmeitsje
Dizze seksje sil jo helpe te begjinnen mei it meitsjen fan jo alderearste testskript, dat jo nuttich wêze sil om API's te konvertearjen yn 'e foarm fan in karate-ramt.
Foardat wy de basiskaratetestskripts skriuwe,ynstallearje asjebleaft de folgjende easken op jo masine:
- Eclipse IDE
- Maven. Stel de passende Maven paad.
- JDK & amp; JRE. Stel it passende paad yn.
Litte wy de stap-foar-stap oanpak sjen:
#1) Meitsje in nij MAVEN Projekt yn Eclipse Editor
- Iepenje Eclipse
- Klik op Triem. Selektearje nij projekt.
- Selektearje Maven Project
- Kies de lokaasje fan it wurkromte.
- Selektearje it Archetype (meastentiids kieze wy " Maven-archetype-quickstart 1.1 " foar ienfâldige Maven-projekten).
- Sykje de groep ID & amp; de Artifact ID (wy hawwe de folgjende wearden brûkt yn ús foarbyld).
- Groep ID : Karate
- Artifact ID: KarateTestScriptsSample
- Klik op Finish om de setup.
#2) Sadree't jo makke binne, kinne jo no de folgjende struktuer sjen yn it Project Explorer-finster.
#3) Al jo Ofhinklikens opnimme.
Us earste stap, nei de opset sille wy alle ôfhinklikens opnimme dy't nedich binne foar de útfiering. Wy sille alle tags hâlde ûnder de POM.xml (oannommen dat jo al bewust binne fan it POM.xml-gebrûk).
- Iepenje POM.xml en kopiearje de ûndersteande koade ûnder de ôfhinklikenstag en bewarje de bestân.
com.intuit.karate karate-apache 0.9.5 test com.intuit.karate karate-junit4 0.9.5 test
Klik hjir foar boarne.
#4) Litte wy it senario brainstoarmje, wat sille wy testje yn