Have ideas to improve npm?Join in the discussion! »

msw-when-then

1.5.1 • Public • Published

logo

MSW When Then

A non-invasive `when-then` style API for MSW.

Npm Version Test status

Why?

MSW is a brilliant tool for mocking, but is missing a few things to make it perfect for testing. msw-when-then aims to help with that.

Notable Features

  • Succinct when-then style Api
  • Mock Chaining
  • Implicitly assert request data is correct
  • Support for both Rest and GraphQL requests

Installation

npm install msw-when-then

Usage

Initialise using MSW server and rest:

import { whenThen, get, ok } from "msw-when-then";

const { when } = whenThen(server, rest);

Then in your test:

when(get("https://some.url")).thenReturn(ok({ foo: "bar" }));

Features

Chaining Mocks

Familiar chaining pattern, the responses are return in order with the last response returned for all subsequent requests.

import { get, badRequest, ok } from "msw-when-then";

when(get("https://some.url"))
  .thenReturn(badRequest({ response: "first request" }))
  .thenReturn(ok({ response: "subsequent requests" }));

Custom Resolvers

Sometimes you need to take things into your own hands. We expose the original MSW resolver function, so you can do whatever you like. See MSW Docs for more details.

import { get } from "msw-when-then";

when(get("https://some.url")).then((req, res, ctx) => {
  // Any additional logic here
  return res(ctx.status(400), ctx.json({ response: "last response" }));
});

Implicitly assert request data

Mocking APIs is great, but how can we ensure our app is sending the right data? We can do this by specifying the expected request data when mocking.

Note: The id key in the withParams here matches the :id argument in the post url

import { post, request, withBody, withHeaders, withParams, ok } from "msw-when-then";

when(post("https://some.url/:id")).thenReturnFor(
  request(
    withBody({ foo: "bar" }),
    withHeaders({ "content-type": "application/json" }),
    withParams({ id: "expected-id" })
  ),
  ok({ response: "success" })
);

Install

npm i msw-when-then

DownloadsWeekly Downloads

224

Version

1.5.1

License

MIT

Unpacked Size

701 kB

Total Files

51

Last publish

Collaborators

  • avatar