DEV Community


Change HTTP status codes for UI testing

renee profile image Renée ・3 min read

This miniblog simulates a backend error to check how Unsplash app behaves when encountering a Searching issue.

Get Started

Instead of asking backend developers for fake status codes to test different user cases, we could use a debugging tool named Proxyman. Basically, it's a handy tool when debugging mobile and web applications as it allows developers to modify both requests and responses on-the-fly. After setting up Proxyman certificate on my iOS device, all requests coming from/to my device are captured by Proxyman under the Remote devices section

Alt Text

We can double click an URL to see the content of its Response. The origin Status code is 200 OK

Alt Text

After that, we can enable the Map Local tool to start monitoring the Requests and Responses

Alt Text

Subsequently, the Map Local tool's window will pop-up so that we can start the mapping configuration.

Alt Text

Modify Status Code

Similar to modifying the body content of the origin Response, we are able to change the status code with our Editor. The File Path indicates the current location of the origin Response (normally, it stays at our Desktop). Click to open the file with our favorite Editor

Alt Text

... then change the Status Code to 404 to simulate that the device was able to communicate with the server, but the server could not find what was requested.

Alt Text

Create Matching Rule

The next step is to define rule so that Proxyman can capture our domain. This way, it would detect all API calls that match the rule and then serve the configured status code from our local file instead of from server. 

Type in the domain for mapping

Alt Text

... then select the modified Response and hit Done

Alt Text

As soon as we make another call to that API, Proxyman would capture that request and map the response with the modified one on our local directory. Now if you click the Header of the received Response, there will be an extra row added to indicate that the Response is being served from our local file, not the server.

Alt Text

And the Unsplash app shows a black screen instead of displaying images for our Search.

Alt Text

Alt Text

If we want to test UI for another backend error, we can simply change the status code again.

What's next?

Modifying status code comes in handy when developing and testing mobile applications. Using the Map Local will allow developers or testers to easily simulate a front-end or back-end error and see how the app behaves in different scenarios without involving backend team.

In the next blog post, we are going to discover how to use Map Remote feature in case you have a development version of a site and would like to be able to browse the production site with some of the requests being served from development. Stay tuned and see you in our next blog post!

Proxyman is a high-performance macOS app, which enables developers to observe and manipulate HTTP/HTTPS requests/responses on your macOS, iOS devices, iOS Simulator and Android devices. Get it at

Discussion (0)

Editor guide