\n\n## Why?\n\n[MSW](https://mswjs.io/) is a brilliant tool for mocking, but is missing a few things to make it perfect for testing.\nmsw-when-then aims to help with that.\n\n## Notable Features\n\n- Succinct `when-then` style Api\n- Mock Chaining\n- Implicitly assert request data is correct\n- Support for both Rest and GraphQL requests\n\n## Installation\n\n`npm install msw-when-then`\n\n## Usage\n\n### Initialise using MSW `server` and `rest`:\n\n```js\nimport { whenThen, get, ok } from \"msw-when-then\";\n\nconst { when } = whenThen(server, rest);\n```\n\n### Then in your test:\n\n```js\nwhen(get(\"https://some.url\")).thenReturn(ok({ foo: \"bar\" }));\n```\n\n---\n\n## Features\n\n### Chaining Mocks\n\nFamiliar chaining pattern, the responses are return in order with the last response returned for all subsequent requests.\n\n```js\nimport { get, badRequest, ok } from \"msw-when-then\";\n\nwhen(get(\"https://some.url\"))\n .thenReturn(badRequest({ response: \"first request\" }))\n .thenReturn(ok({ response: \"subsequent requests\" }));\n```\n\n### Custom Resolvers\n\nSometimes you need to take things into your own hands. We expose the original MSW resolver function, so you can do whatever you like.\nSee [MSW Docs](https://mswjs.io/docs/basics/response-resolver) for more details.\n\n```js\nimport { get } from \"msw-when-then\";\n\nwhen(get(\"https://some.url\")).then((req, res, ctx) => {\n // Any additional logic here\n return res(ctx.status(400), ctx.json({ response: \"last response\" }));\n});\n```\n\n### Implicitly assert request data\n\nMocking APIs is great, but how can we ensure our app is sending the right data? We can do this by specifying the expected\nrequest data when mocking.\n\n_Note: The `id` key in the `withParams` here matches the `:id` argument in the `post` url_\n\n```js\nimport { post, request, withBody, withHeaders, withParams, ok } from \"msw-when-then\";\n\nwhen(post(\"https://some.url/:id\")).thenReturnFor(\n request(\n withBody({ foo: \"bar\" }),\n withHeaders({ \"content-type\": \"application/json\" }),\n withParams({ id: \"expected-id\" })\n ),\n ok({ response: \"success\" })\n);\n```\n","readmeFilename":"README.md"}
![\"logo\"](\"docs/static/img/logo.svg\"){kind=logo}
\n![\"Npm](\"https://img.shields.io/npm/v/msw-when-then\")
\n ![\"Test](\"https://github.com/redhwannacef/msw-when-then/workflows/Tests/badge.svg\"){kind=icon}
\n