{"id":9526,"date":"2020-10-19T10:28:03","date_gmt":"2020-10-19T08:28:03","guid":{"rendered":"https:\/\/sii.pl\/blog\/?p=9526"},"modified":"2023-08-10T15:25:17","modified_gmt":"2023-08-10T13:25:17","slug":"charles-pomocne-narzedzie-w-testowaniu-rest-api","status":"publish","type":"post","link":"https:\/\/sii.pl\/blog\/charles-pomocne-narzedzie-w-testowaniu-rest-api\/","title":{"rendered":"Charles – pomocne narz\u0119dzie w testowaniu REST API"},"content":{"rendered":"\n

Charles jest ciekawym narz\u0119dziem, kt\u00f3re mo\u017ce okaza\u0107 si\u0119 pomocne w pracy testera.<\/span><\/p>\n\n\n\n

Dost\u0119pne do pobrania pod adresem: https:\/\/www.charlesproxy.com\/<\/a><\/span><\/p>\n\n\n\n

Czym jest Charles?<\/h3>\n\n\n\n
\"strona<\/a><\/figure>\n\n\n\n

Charles Web Debugging Proxy to wieloplatformowa aplikacja serwera proxy do debugowania HTTP napisana w Javie. Umo\u017cliwia u\u017cytkownikowi przegl\u0105danie HTTP, HTTPS, HTTP \/ 2 i w\u0142\u0105cza ruch port\u00f3w TCP dost\u0119pny z, do, lub przez komputer lokalny (Wikipedia – przet\u0142umaczone z j\u0119zyka angielskiego).<\/p>\n\n\n\n

Jest to narz\u0119dzie p\u0142atne. Przez 30 dni mo\u017cna skorzysta\u0107 z wersji pr\u00f3bnej. Bezp\u0142atn\u0105 alternatyw\u0105 jest Fiddler – niestety jest on mniej przyjazny, je\u017celi chodzi o interfejs i skonfigurowanie. W projekcie, w kt\u00f3rym pracowa\u0142em Fiddler nie chcia\u0142 wsp\u00f3\u0142pracowa\u0107, natomiast wdro\u017cenie Charlesa okaza\u0142o si\u0119 szybkie i bezproblemowe.<\/span><\/p>\n\n\n\n

Projekt, w kt\u00f3rym jestem testerem dotyczy aplikacji medycznej dla pacjent\u00f3w (umawianie spotka\u0144, przegl\u0105danie wynik\u00f3w bada\u0144), kt\u00f3ra poprzez REST API \u0142\u0105czy si\u0119 z wielkim systemem do obs\u0142ugi plac\u00f3wek medycznych (aplikacja desktopowa).<\/span><\/p>\n\n\n\n

REST API<\/h3>\n\n\n\n

W przypadku testowania REST API w projekcie u\u017cywany jest Postman. Jednak w trakcie trwania, do stacka technologicznego doszed\u0142 r\u00f3wnie\u017c Charles i narz\u0119dzie to zrobi\u0142o na mnie du\u017ce wra\u017cenie.<\/span><\/p>\n\n\n\n

Deweloper doda\u0142 do naszej aplikacji mobilnej przekierowanie proxy, kt\u00f3re umo\u017cliwi\u0142o aplikacji Charles na Windows 10 wy\u015bwietlanie request\u00f3w z aplikacji mobilnej (wielkie dzi\u0119ki dla Tomka Marzeion ?)<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Charles umo\u017cliwia podgl\u0105d endpoint\u00f3w, a tak\u017ce wysy\u0142anych requst\u00f3w i otrzymywanych odpowiedzi na \u017cywo w trakcie korzystania z aplikacji:<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Charles pozwala tak\u017ce przegl\u0105da\u0107 dane strukturalnie:<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Podgl\u0105d odbieranych i wysy\u0142anych danych jest bardzo przejrzysty i wygodny. Przechwycone endpointy mo\u017cna za pomoc\u0105 kopiuj\/wklej doda\u0107 do Postmana. Moim zdaniem w tym aspekcie Charles przydaje si\u0119 <\/span>bardziej ni\u017c Postman i w spos\u00f3b przejrzysty wida\u0107 jakie zapytania s\u0105 odbierane i wysy\u0142ane.<\/p>\n\n\n\n

Przechwytuj\u0105c request mo\u017cna ustawi\u0107 \u201cBreakpoint\u201d, kt\u00f3ry w momencie, kiedy aplikacja natrafi na dany request, pozwoli go modyfikowa\u0107 i przejrze\u0107 jego zawarto\u015b\u0107.\u00a0<\/span><\/p>\n\n\n\n

Punkt wstrzymania<\/b> lub pu\u0142apka<\/b> (ang. breakpoint<\/i>) \u2013 miejsce celowego wstrzymania wykonania programu w celu przeanalizowania jego dzia\u0142ania. Uruchomiony pod kontrol\u0105 debuggera program przerywa wykonanie we wskazanym punkcie i przekazuje sterowanie do debugera, kt\u00f3ry zazwyczaj wy\u015bwietla kod \u017ar\u00f3d\u0142owy w miejscu wywo\u0142ania wskazanej instrukcji. Po wstrzymaniu mo\u017cliwe jest m.in. \u015bledzenie aktualnych warto\u015bci zmiennych oraz zawarto\u015bci rejestr\u00f3w procesora. Zintegrowane \u015brodowiska programistyczne pozwalaj\u0105 na ustawienie takich punkt\u00f3w bezpo\u015brednio w edytorze kodu oraz definiowanie warunk\u00f3w, jakie musi spe\u0142nia\u0107 stan wykonania programu, aby pu\u0142apka spowodowa\u0142a przerwanie wykonania programu<\/sup> (Wikipedia)<\/p>\n\n\n\n

Oczywi\u015bcie ustawione \u201cBrakpointy\u201d w ustawieniach (Proxy -> Breakpoint Settings) mo\u017cna modyfikowa\u0107 na przyk\u0142ad poprzez ustawienia tzw.\u00a0<\/span>\u201cwild card\u201d.<\/span><\/a><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n

Dla przyk\u0142adu ni\u017cej wida\u0107 request, kt\u00f3ry odwo\u0142uje si\u0119 do pojedynczego konkretnego spotkania.<\/span><\/p>\n\n\n\n

Je\u017celi u\u017cytkownik kliknie w to spotkanie, takie zapytanie zostanie wys\u0142ane i zwr\u00f3cone zostan\u0105 szczeg\u00f3ly spotkania. Inne spotkania b\u0119d\u0105 ju\u017c mia\u0142y inny numer, wi\u0119c w tym miejscu mo\u017cemy zastosowa\u0107 \u201cwild card\u201d i u\u017cy\u0107 * podobny znak u\u017cywamy w SQL, gdy chcemy przejrze\u0107 wszystkie wyniki np. select * from nazwa_tabeli. Po zmodyfikowaniu \u201cBreakpointu\u201d b\u0119dzie dzia\u0142a\u0107 na ka\u017cdym innym spotkaniu:<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Charles jest r\u00f3wnie\u017c przydatny w sprawdzeniu odpowiedzi, jakie otrzymujemy. Mo\u017cemy \u0142atwo przejrze\u0107 JSON, a tak\u017ce ilo\u015b\u0107 obiekt\u00f3w i ich w\u0142a\u015bciwo\u015bci.<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n
<\/div>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n

W moim projekcie Charles ma du\u017ce zastosowanie, je\u017celi chodzi o modyfikowanie kodu odpowiedzi.<\/a>\u00a0Na przyk\u0142ad, w przypadku jak aplikacja zachowa si\u0119 w momencie, kiedy zmodyfikujemy status odpowiedzi z kodu 200(OK) na kod 500 (Internal Server Error).<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Network throttling<\/h3>\n\n\n\n

W Charles mo\u017cemy tak\u017ce skorzysta\u0107 z opcji pozwalaj\u0105cej nam ustawi\u0107 parametry po\u0142\u0105czenia internetowego. (Throttle Settings -> Enable Throttling)<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Nale\u017cy pami\u0119ta\u0107, \u017ce gdy mamy w\u0142\u0105czon\u0105 funkcje zwolnieniu ulegnie przepustowo\u015b\u0107 tak\u017ce, gdy b\u0119dziemy korzysta\u0107 z przegl\u0105darki internetowej na komputerze, wi\u0119c jest to dobre narz\u0119dzie do testowania aplikacji webowej i sprawdzenia jak b\u0119dzie dzia\u0142a\u0107 aplikacja w warunkach s\u0142abszego po\u0142\u0105czenia internetowego.<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Ikona \u201c\u017c\u00f3\u0142wia\u201d pozwala nam kontrolowa\u0107 t\u0119 funkcj\u0119 (w\u0142\u0105czenie \/ wy\u0142\u0105czenie):<\/span><\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Narz\u0119dzie to posiada tak\u017ce wiele innych opcji np. tworzenie mock response. Podsumowuj\u0105c, Charles mo\u017ce by\u0107 w pracy testera ciekaw\u0105 alternatyw\u0105 dla Postmana i w niekt\u00f3rych aspektach by\u0107 bardzo pomocny (breakpointy, modyfikowanie request\u00f3w, podgl\u0105d w czasie rzeczywistym zapyta\u0144 i odpowiedzi). W projekcie, w kt\u00f3rym mam przyjemno\u015b\u0107 pracowa\u0107, korzystanie z tego narz\u0119dzia jest wygodne i znacznie u\u0142atwia prac\u0119 testerom. <\/span><\/p>\n\n\n\n

Zach\u0119cam do wypr\u00f3bowania i poznania Charles \ud83d\ude42<\/p>\n\n\n\n

\n\n\n\n

Chcesz lepiej zrozumie\u0107 aplikacje i systemy, kt\u00f3re testujesz? Do\u0142\u0105cz do ModernTester, poznaj najpotrzebniejsze narz\u0119dzia, frameworki oraz j\u0119zyki programowania i \u0107wicz na specjalnie przygotowanych \u015brodowiskach testowych: Platforma e-learningowa ModernTester<\/a><\/p>\n\n\n

\n \n
\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n \n
\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n
\n \n\n
<\/div>\n <\/div>\n <\/div>\n<\/div>\n \n\n
\n 5\/5 ( votes: 9) <\/div>\n <\/div>\n","protected":false},"excerpt":{"rendered":"

Charles jest ciekawym narz\u0119dziem, kt\u00f3re mo\u017ce okaza\u0107 si\u0119 pomocne w pracy testera. Dost\u0119pne do pobrania pod adresem: https:\/\/www.charlesproxy.com\/ Czym jest … Continued<\/a><\/p>\n","protected":false},"author":190,"featured_media":9810,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_editorskit_title_hidden":false,"_editorskit_reading_time":0,"_editorskit_is_block_options_detached":false,"_editorskit_block_options_position":"{}","inline_featured_image":false,"footnotes":""},"categories":[1317],"tags":[953,954,955,957,956],"class_list":["post-9526","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-testowanie","tag-charles","tag-charles-proxy","tag-http","tag-postman","tag-rest-api"],"acf":[],"aioseo_notices":[],"republish_history":[],"featured_media_url":"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/07\/Charles-pomocne-narz\u0119dzie-w-testowaniu-REST-API.jpg","category_names":["Testowanie"],"_links":{"self":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/9526"}],"collection":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/users\/190"}],"replies":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/comments?post=9526"}],"version-history":[{"count":3,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/9526\/revisions"}],"predecessor-version":[{"id":23414,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/posts\/9526\/revisions\/23414"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media\/9810"}],"wp:attachment":[{"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/media?parent=9526"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/categories?post=9526"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sii.pl\/blog\/wp-json\/wp\/v2\/tags?post=9526"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}