Mocking error responses

When it comes to mocking an error response, it's recommended to compose a valid response using res() composition chain, rather than throwing an exception inside a request handler. This is mainly to distinguish between internal and intended exceptions.

By treating an error response as an actual response, and not an exception, you respect the standard and ensure your client code receives and handles a valid error response.

Examples

Here's an example on how to mock an error response for the login POST request:

1import { setupWorker, rest } from 'msw'
2
3const worker = setupWorker(
4  rest.post('/login', async (req, res, ctx) => {
5    const { username } = await req.json()
6
7    return res(
8      // Send a valid HTTP status code
9      ctx.status(403),
10      // And a response body, if necessary
11      ctx.json({
12        errorMessage: `User '${username}' not found`,
13      }),
14    )
15  }),
16)
17
18worker.start()

1{
2  "username": "admin"
3}

1{
2  "errorMessage": "User 'admin' not found"
3}