Mock Error Responses in MSW

Share this video with your friends

Social Share Links

Send Tweet
Published a year ago
Updated a year ago

Error handling is crucial for a great user experience. Learn how to reproduce any error response with Mock Service Worker, be it a 404, 500, or any other HTTP error response.

Instructor: [0:05] When working on the UI that fetches data, we have to account for different network-related states such as error responses, latency, and connectivity issues. In our movie recommendations component, we want to display a user-friendly error message whenever fetching the recommendations fails. With MSW, we can reproduce any network state using request handlers.

[0:22] To respond to a request with an error, construct a valid response instance, and set its status property to reflect the server error you want. In our case, let's see how our UI handles a response with a 500 status code, which indicates a generic server error when handling this request.

[0:40] We've got our request handler pinned to always return an error response, which is handy while working on error handling in our application. Same as with successful responses, we can see this 500 response in the Network tab, in the browser's DevTools. To toggle between the success and error responses, we can return our 500 response conditionally.

[1:00] As an example, let's respond with an error only when fetching recommendations for a particular movie. With this condition in place, we can now check different states of the UI by opening different movies in the browser.

[1:13] You can utilize error responses to help you develop features or catch issues. For example, it's a good idea to check if the movieId query parameter has been sent by the client, and if it's missing, respond with a 400 response indicating a bad request and a JSON body describing what's wrong.

~ a year ago

I ran into an issue with return HttpResponse(null, { status: 500 }). Is this still the API because the documentation for HttpResponse seems to imply that you cannot send null: https://mswjs.io/docs/api/http-response#call-signature.

Also, there seems to be a static method HttpResponse.error but it says in the documentation that "neither HttpResponse.error() nor Response.error() allow customizing the network error response".

With that said, the error I see displayed in the UI is "SyntaxError: JSON.parse: unexpected end of data at line 1 column 1 of the JSON data". This doesn't seem as useful as the error message presented in this video.

Artem Zakharchenko
Artem Zakharchenkoinstructor
~ a year ago

Hi! Thanks for letting me know.

The docs mention that the HttpResponse construct signature is equal to the Response construct signature, whose body argument supports both null and undefined. The docs repeat that in types a bit incorrectly, it seems, confusing you whether null is allowed. It is.

The HttpResponse.error() static method is the proxy for the standard Response.error() method, and is meant for network errors, not error responses. I mention the difference between the two on this page.

Regarding the SyntaxError you experienced, it sounds like something else is off. If you share a repository/sandbox, I can take a look and help you figure out why you're getting the JSON.parse error instead.

Markdown supported.
Become a member to join the discussionEnroll Today