Mae'r tiwtorial hwn yn gyflwyniad i Brofi API gan ddefnyddio Karate Framework. Dysgwch am strwythur Sgript Prawf Karate a chamau i adeiladu'r sgript prawf cyntaf:
Acronym yw API sy'n sefyll am Application Programming Interface. Yn syml, gallwn ei ddiffinio fel cyfryngwr meddalwedd sy'n caniatáu cyfathrebu rhwng rhaglenni.
Mae angen profion API arnom oherwydd:
- Cyhoeddir canlyniadau yn gyflymach, felly dim aros i weld a yw'r API yn gweithio'n iawn.
- Gyda'r ymateb cyflymach, mae defnyddio'r APIs hyn hefyd yn dod yn gyflymach, felly mae'n caniatáu amser gweithredu cyflym.
- Canfod methiant yn gynnar, hyd yn oed cyn i UI yr ap gael ei greu, caniatewch i ni liniaru risgiau a chywiro diffygion.
- Mae'n bosibl dosbarthu ar raddfa fawr mewn cyfnod byrrach.
Er mwyn gallu gweithio ar Brofion API, mae gennym ni amrywiol offer ar gael yn y farchnad fel Postman, Mocha, a Chai. Mae'r rhain wedi dangos canlyniadau da a defnydd effeithiol ar gyfer profi APIs, fodd bynnag, mae'r rhain yn cael eu dylanwadu'n drwm gan god. Er mwyn gallu defnyddio'r rhain, rhaid bod yn dechnegol gadarn ac yn gyfarwydd ag ieithoedd rhaglennu.
Mae'r Karate Framework yn datrys y rhifyn hwn o'i offer meddalwedd blaenorol yn hyfryd.
Beth Yw Fframwaith Karate
Karate? Gadewch i ni siarad Karate. Ai dyma'r un o Japan? Beth yw eich barn chi? Efallai mai dyna'r Bruce mawry Sgript Brawf Sylfaenol Karate hon.
Senario:
Byddwn yn profi API gyda'r URL hwn.
Llwybr: api/users/2
Dull: GET
Ac mae angen i ni ddilysu , a yw'r cais yn dychwelyd Cod Llwyddiant ( 200) neu beidio.
Yn syml, rydym yn mynd i brofi API sampl i weld a yw'n cael ei weithredu'n llwyddiannus ai peidio.
Sylwer: Rydym yn cymryd sampl API sydd ar gael i'w brofi. Gallech ddewis unrhyw LLWYBR neu gyfeirio at eich API.
Cliciwch yma am ffynhonnell.
#5) Ein cam nesaf nawr fyddai creu ffeil .feature .
Fel y trafodwyd yn yr adran gyflwyno, y ffeil .feature yw'r eiddo sydd wedi'i etifeddu gan Cucumber. Yn y ffeil hon, byddwn yn ysgrifennu'r senarios prawf sydd angen eu gweithredu ar gyfer cynnal y Profion API.
- De-Cliciwch arno a chreu ffeil newydd – userDetails.feature. Yna cliciwch ar y botwm Gorffen.
Nawr fe welwch y ffeil ganlynol o dan y ffolder src/test/java 3>
Mae'r eicon lliw gwyrdd yn ymdebygu i'r .feature fi le mewn Ciwcymbr yr ydym newydd ei greu.
- 5> Unwaith y bydd y ffeil wedi'i chreu, nawr byddwn yn ysgrifennu ein senarios prawf a fydd yn cael eu trafod yn yr adran ganlynol.
#6) Gan fod gennym y senario ay ffeil wag . nodwedd yn barod, nawr gadewch i ni ddechrau gyda'n sgript gyntaf. Gadewch i ni ddechrau codio
Ysgrifennwch y llinell Cod ganlynol o dan ffeil userDetails.feature a grëwyd gennym yng Ngham #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
Gadewch inni geisio deall y cydrannau sydd wedi'u hysgrifennu yn y ffeil uchod:
- Nodwedd: Mae allweddair yn esbonio enw'r nodwedd rydyn ni'n ei phrofi.
- Cefndir: Mae hon yn adran ddewisol sy'n cael ei thrin fel adran Rhagofyniad. Gellir defnyddio hwn i ddiffinio beth sydd ei angen i brofi'r API. Mae'n cynnwys HEADER, URL & Opsiynau PARAM .
- Senario: Bydd gan bob ffeil nodwedd y byddwch yn ei gweld o leiaf un nodwedd (er y gall roi lluosog senarios) . Dyma'r disgrifiad o'r achos prawf.
- O ystyried: Dyma'r cam sydd angen ei gyflawni cyn cyflawni unrhyw gam prawf arall. Mae'n weithred orfodol i'w chyflawni.
- Pryd: Mae'n pennu'r amod y dylid ei fodloni i gyflawni'r cam prawf nesaf.
- Yna: Mae'n dweud wrthym beth ddylai ddigwydd rhag ofn bod y cyflwr a grybwyllir yn y Pan yn fodlon.
Sylwer: Mae'r holl eiriau allweddol uchod yn o'r iaith Gherkins. Dyma'r ffordd safonol o ysgrifennu'r sgriptiau prawf gan ddefnyddio Ciwcymbr.
A rhai geiriau eraill a ddefnyddir yn y ffeil nodwedd yw:
- 200: Dyma'r cod statws/ymatebdisgwyl (Cliciwch yma am y rhestr o godau statws)
- GET: Dyma'r dull API fel POST, PUT, etc.
Gobeithiwn yr esboniad hwn roedd yn hawdd i chi ei ddeall. Nawr byddwch yn gallu cysylltu â beth yn union sydd wedi'i ysgrifennu yn y ffeil uchod.
Nawr mae angen i ni greu ffeil TestRunner.java
Fel yr eglurwyd yn yr uchod adran, mae Cucumber angen ffeil Runner a fyddai'n ofynnol i weithredu'r ffeil .feature sy'n cynnwys y senarios profi.
- Ewch i Ffolder src/test/java yn eich prosiect
- De-Cliciwch arno a chreu ffeil Java Newydd: TestRunner.java
- Ar ôl i'r ffeil gael ei chreu, rhowch y llinellau cod canlynol oddi tani:
import org.junit.runner.RunWith; import com.intuit.karate.junit4.Karate; @RunWith(Karate.class) public class TestRunner { } - Test Runner yw'r ffeil a fydd nawr yn cael ei gweithredu i berfformio'r senario dymunol sydd wedi'i ysgrifennu o dan Gam #5.
#7) Nawr rydym yn barod gyda'r ddwy ffeil TestRunner.Java a userDeatils.feature. Yr unig dasg sydd ar ôl i ni yw Rhedeg y sgript.
> 
#8) Last, the Karate mae fframwaith hefyd yn rhoi cyflwyniad adroddiad HTML ar gyfer y gweithrediad a gyflawnwyd.
- Ewch i'r Ffolder Targed -> adroddiadau-sicr-> Yma fe welwch eich adroddiad HTML y gallwch ei agor.
** Byddem hefyd yn awgrymu ichi agor yr un peth gan ddefnyddio Chrome Porwr i gael golwg a theimlad gwell.
- Yn dilyn HTML Bydd Adroddiad yn cael ei ddangos i chi gan ddarlunio Senarios & Prawf sydd wedi'i gyflawni ar gyfer y senario a grybwyllwyd:
Casgliad
Yn y tiwtorial hwn, rydym wedi trafod profion API, gwahanol brofion offer sydd ar gael yn y farchnad, a sut mae'r Fframwaith Karate yn opsiwn gwell o'i gymharu â'i gymheiriaid.
Fe wnaethom ddilyn dull cam wrth gam i greu ein sgript prawf sylfaenol cyntaf. Dechreuon ni gyda chreu prosiect Maven sylfaenol yn Eclipse IDE i greu ffeil .feature, sy'n cynnwys yr holl senario profi a ffeil Runner i weithredu'r achos prawf a grybwyllir yn y ffeil .feature.
0>Ar ddiwedd y camau lluosog, gallem weld adroddiad gweithredu canlyniadau'r prawf.Gobeithiwn fod y tiwtorial hwn wedi bod o gymorth i'r dechreuwyr ddysgu sut i adeiladu eu sgript prawf cyntaf gan ddefnyddio'r Fframwaith Karate a chynnal Profion API. Mae hyn yn fanwl cam-wrth-gammae ymagwedd yn ffordd wych o redeg a chynnal profion amrywiol ar yr API.
NESAF>>
Roedd Lee wedi datblygu hyn yn ei amser rhydd.Er yr hoffem ymchwilio i wreiddiau diddorol Karate, am y tro, gadewch i ni siarad am yr offeryn Karate sydd wedi'i ddatblygu gan Peter Thomas , un o'r arfau gwych sy'n dod i achub profwyr API.
Mae fframwaith Karate yn dilyn arddull Ciwcymbr o ysgrifennu'r rhaglen sy'n dilyn y dull BDD. Mae'r gystrawen yn hawdd i'w deall gan rai nad ydynt yn rhaglennu. A'r fframwaith hwn yw'r unig offeryn profi API sydd wedi cyfuno API Automation a phrofi perfformiad yn un offeryn annibynnol.
Mae'n rhoi'r gallu i ddefnyddwyr weithredu'r achosion prawf yn Parallel a pherfformio'r JSON & Gwiriadau XML.
Gyda'r wybodaeth hon, gellir casglu rhai pwyntiau allweddol er mwyn deall yr offeryn Karate ymhellach yn fanwl:
- Fframwaith profi BDD yw Karate yn lle hynny o TDD.
- Mae wedi'i gynllunio i fod yn hawdd i'r rhai nad ydynt yn rhaglennu. Mae'r nodwedd hon yn newidiwr gêm gan ei fod yn caniatáu ar gyfer mwy o ddefnydd a mynediad gan lawer o bobl waeth beth fo'u cefndir technegol neu allu.
- Mae'n gwneud defnydd o'r ffeil nodwedd Ciwcymbr ac iaith Gherkins i ysgrifennu'r prawf, sef hawdd iawn i'w ddeall.
Mae'r holl nodweddion hyn yn ei wneud yn un o'r offer awtomeiddio mwyaf ffafriol sydd ar gael heddiw.
Fframwaith Hanes Karate
Crëwyd gan ' Peter Thomas' yn 2017, nod y feddalwedd hon yw gwneud profionswyddogaethau ar gael yn rhwydd i bawb. Fe'i hysgrifennwyd yn Java ac roedd y rhan fwyaf o bobl yn disgwyl i'w ffeiliau fod yn yr un iaith hefyd, fodd bynnag, yn ffodus, nid felly y mae.
Yn hytrach, mae'n defnyddio ffeiliau Gherkins, sy'n ganlyniad i'w berthynas â'r Fframwaith ciwcymbr. Mae'r meddalwedd awtomeiddio yn estyniad o Cucumber, felly mae'n etifeddu'r defnydd o ffeil Gherkins yn ei weithrediad. Y gwahaniaeth mawr rhwng y ddau yw nad yw Karate yn gwneud unrhyw ddefnydd o Java wrth brofi, ond mae Cucumber yn gwneud hynny.
Dyma'r union reswm pam ei fod yn darparu ar gyfer y rhai nad ydynt yn rhaglennu gan fod cystrawen Gherkins yn hynod ddarllenadwy a chynhwysfawr. Dyma'r rheswm pam mae Karate yn fwyaf addas ac yn cael ei argymell ar gyfer gwneud mynediad i fyd profi API awtomataidd.
Dyma rai o nodweddion y Fframwaith Profi Karate:
4- Cymorth Web Socket
- Cais SOAP
- HTTP
- Trin cwci porwr
- HTTPS
- Data ffurf HTML
- Cais XML
Cymharu Karate Vs Rest-Assured
Rest Assured : Mae'n llyfrgell wedi'i seilio ar Java i brofi gwasanaethau REST. Mae'n defnyddio iaith Java ar gyfer ysgrifennu'r llinellau cod. Mae'n helpu i brofi nifer o gategorïau o geisiadau, sy'n arwain ymhellach at ddilysu gwahanol gyfuniadau rhesymeg busnes.
Fframwaith Karate : Offeryn wedi'i seilio ar Ciwcymbr/Gherkins, a ddefnyddir i brofi SEBON & Gwasanaethau REST.
Mae'r tabl canlynol yn rhestru ychydig o wahaniaethau mwy amlwg rhwng Rest-Assured & Fframwaith Karate:
| Sail | Fframwaith Karate | REST-Sicr | 20|
|---|---|---|---|
| 1 | Iaith | Mae'n defnyddio cyfuniad o Ciwcymbr a Gherkins | Mae'n gwneud defnydd o Java Language |
| 2 | Maint y Cod | Fel arfer, llinell y cod yn llai, gan ei fod yn dilyn strwythur tebyg i ciwcymbr | Mae llinell y cod yn fwy gan ei fod yn cynnwys ydefnydd o iaith Java |
| 3 | Gwybodaeth Dechnegol ofynnol | Gall pobl nad ydynt yn rhaglenwyr ysgrifennu'n hawdd y cod Gherkins | mae angen gwybodaeth dechnegol i ysgrifennu cod Java |
| 4 | Profi a yrrir gan Ddata | Angen defnyddio TestNG neu gyfwerth i gynnal yr un peth | Gellir defnyddio tagiau mewnol i gefnogi profi data |
| 1>5 | A yw'n darparu cymorth galwad SEBON | Ydy, mae'n darparu | Mae'n ymwneud â chais REST yn unig |
| 6 | Profi Cyfochrog | Ydy, mae profi cyfochrog yn cael ei gefnogi'n hawdd gyda chynhyrchu adroddiadau cyfochrog rhy | Ddim i raddau helaeth. Er bod pobl wedi ceisio gwneud hyn, mae'r gyfradd fethiant yn fwy na'r gyfradd llwyddiant |
| 7 | Adrodd 23 | Mae'n darparu adroddiadau mewnol, felly nid oes angen iddo fod yn ddibynnol ar ategion allanol. Gallwn hyd yn oed ei integreiddio ag ategyn adrodd Ciwcymbr ar gyfer UI gwell. | Angen dibynnu ar Ategion Allanol fel Junit, TestNG |
| 8 23> | Cymorth CSV ar gyfer Data allanol | Ie, o Karate 0.9.0 | Na, rhaid defnyddio Java Code neu lyfrgell |
| 9 | Web UI Automation | Ie, o Karate 0.9.5 Mae Web-UI Automation yn bosibl | Na, nid yw'n cael ei gefnogi |
| 10 | Sampl GET | Given param val1 = ‘name1’
| 22>
3.