README.md

Create React App (GraphQL)

This repository illustrates how to use Mock Service Worker to mock a GraphQL API for development, unit and E2E testing in Create React App project.

Technologies

• Create React App
• Apollo as a GraphQL client;
• Jest for running unit tests;
• React Testing Library for unit test assertions;
• Cypress for running E2E tests;

Getting started

$ git clone https://github.com/mswjs/examples.git
$ cd examples
$ yarn
$ cd graphql-react-apollo

Running locally

$ yarn start

Tests

Unit tests

$ yarn test:unit

E2E tests

$ yarn test:e2e

Key points

• src/mocks/handlers.js describes GraphQL operations to mock.

Browser

• src/index.js conditionally enables mocking in development environment.
• src/ApolloClient.js uses an explicit fetch reference in order for requests to be captured and deferred until the Service Worker is ready. Necessary due to Apollo hoisting a native window.fetch call, preventing Mock Service Worker from properly capturing it.
• public/mockServiceWorker.js the Service Worker, created by running npx msw init public.

NodeJS

• src/setupTests.js enables mocking for unit tests via beforeAll/afterAll hooks.