Wprowadzenie

Postman jest narzędziem, które wykorzystuję codziennie i bez którego nie wyobrażam sobie pracy. Dzisiaj chciałbym Ci pokazać, w jaki sposób można zaimportować żądanie z DevTools (Chrome) do Postmana, aby ułatwić sobie pracę i testowanie aplikacji. W szczególności, gdy jakieś żądanie powoduje błąd (np. 500).

Dodatkowo, gdy nauczymy naszych testerów, aby do zadań wrzucali tak wyeksportowane żądania, to praca w szczególności nad problemami staje dużo łatwiejsza i szybsza. Na ogół nie musimy przechodzić całego scenariusza, aby odtworzyć problem. Wystarczy tylko zaimportować żądanie i można już działać.

Export żądania

Wcześniej czy później w naszej aplikacji pojawi się błąd. A to serwer zwraca błąd 500, a to programiści źle zrozumieli wymagania i aplikacja zachowuje się nie tak, jak powinna.

Na potrzeby dzisiejszego przykładu utworzyłem nową aplikację webową w Visual Studio (.NET Core Web Api + Angular + uwierzytelnienie), w której wprowadziłem błąd. W efekcie w pewnym momencie działania aplikacji jedno z żądań kończy się statusem 500:

Oczywiście pracując nad tym problemem, można za każdym razem przeklikiwać aplikację, aby odtwarzać błąd. Ale dużo fajniejszą opcją jest wyeksportowanie i import problematycznego żądania do Postmana. Dzięki czemu później możemy wykonywać tylko to jedno żądanie. Zyskujemy na czasie i szybciej możemy rozwiązać problem.

Dodatkowo plusem takiego wyeksportowanego żądania jest to, że z czasem możemy również dodać je do listy żądań wykonywanych podczas wdrażania aplikacji lub nocnych buildów (tak jak to opisywałem we wpisie o automatycznym wykonywaniu testów Postmana), dzięki czemu możemy szybciej wyłapać błędy regresji.

Eksport żądania jest bardzo prosty. Wystarczy kliknąć na nie prawym klawiszem myszy. Następnie wybrać opcję Copy i później Copy as cURL (bash):

W efekcie skopiujemy coś takiego:

Import żądania do Postmana

Mając już skopiowany request, wystarczy go już tylko zaimportować. Robi się to w podobny sposób jak import żądań z swagger. Czyli klikamy w przycisk Import, później przechodzimy do zakładki Raw text i wklejamy skopiowane żądanie:

Następnie klikamy na przycisk Continue i po chwili widzimy podsumowanie importu, który za chwilę nastąpi:

Klikamy w przycisk Import i widzimy nowe żądanie w Postmanie. Jest ładnie ustawiony adres oraz wszystkie nagłówki. Możemy teraz wykonać żądanie i sprawdzić, co dzieje się w aplikacji. A następnie naprawić problem:

Podsumowanie

Importowanie żądań z DevToolsów (inne przeglądarki niż Chrome mają podobne możliwości) bardzo przyśpiesza proces naprawiania problemów występujących w aplikacji. W szczególności gdy z testerami aplikacji ustalimy, że podejrzane żądania będą dodawali do zgłoszeń.

Dzięki temu unikniemy wielu niepotrzebnych problemów. Na przykład sprawdzamy nie te środowisko, nie tego użytkownika (o ile na przykład skopiowany token jwt jest jeszcze ważny). W efekcie jesteśmy bardziej wydajni w pracy nad problemami.

A Ty importujesz żądania do Postmana z DevToolsów?