Blog
Engineering
How to manage multiple Front-End projects with a monorepo
A step by step guide on how to manage multiple Front-End projects with a monorepo.
Rui Saraiva
Principal Engineer
Have you ever wondered how to develop a Front-End project without relying on the API being ready and available to fetch data from?
In this tutorial, I’ll share different approaches to how you can do just that, starting by setting up a mock server and then showing how to integrate the mock server into multiple front-end environments — development, test, and component development environments.
Here we go!
Previous experience with mock servers
From previous experience, I’ve used mock servers based on Express.js where I would spin up the mock server and then any other environment server that would target HTTP requests to it.
Although this pattern is very flexible in the way we can use any 3rd party packages we want inside our mock server, it wasn’t always the best fit for being used across the front-end stack environments.
As an example, one common tool we use on front-end projects to develop components is Storybook, and when we get to the part where we assemble pages, more often than not, we have data requirements that need to be fetched from somewhere.
Some of this data can be stored locally on the project and delivered by its own mock server, but what about data coming from 3rd party services?
This case is something that an Express.js mock server won’t cover if your codebase is making the requests directly to the 3rd party services. One way to get around this is by making custom endpoints on the mock server that mock the response from those same 3rd party services. This implies one layer of abstraction on our mock server that may not match our codebase data fetching strategy.
A front-end project should behave the exact same way with or without a mock server. If we start introducing conditionals on our code to handle both scenarios, that’s one extra piece of code we need to maintain.
There is another scenario where using an Express.js mock server for our Storybook environment isn’t a perfect fit. We can use it just fine on our local machines, but what about deploying our Storybook project to something like Chromatic?
When developing locally, we run both the Storybook development server and the Express.js mock server as well, but the same won’t happen when we deploy it.
To deploy a Storybook project, we first build the production version of it, which is a static SPA version of it. This static build is deployed to any server that can deliver static assets, but the mock server isn’t deployed with it.
It would be great to have a mock server that can be used both locally and in “production” environments without any extra setup/configuration.
Enter Mock Service Worker (MSW), a library that provides a seamless API for mocking on the browser and Node.js. It’s being marketed as an “API mocking of the next generation” on their website, and it does the mocking by intercepting requests on the network level.
It mentions that it can be used to reuse the same mock definition for testing, development seamlessly, and debugging.
This kind of seamless integration is what we are aiming for today!
The end goal is to start with the repo from the How to set up a front-end project with Vite, React, and TypeScript blog post as a baseline, add new components with external data requirements and mock those exact requirements with MSW.
MSW for the win
To get us started, we’re going to build upon the project created in the How to set up a front-end project with Vite, React, and TypeScript blog post:
1git clone git@github.com:Pixelmatters/setup-project-demo.git project-demo-msw2cd project-demo-msw3npm install
This will clone the repository into a folder called project-demo-msw and install the NPM dependencies as well.
New component with external data requirements
Let’s create a new component that fetches some data from an external API and then renders some UI accordingly.
1mkdir src/components2touch src/components/users.tsx
Here’s a simple React component with static HTML that you can copy to the src/components/users.tsx file:
1export const Users: React.FC = () => {2 return (3 <div>4 <h1>Users</h1>5 <ul>6 <li>User 1</li>7 <li>User 2</li>8 <li>User 3</li>9 </ul>10 </div>11 )12}
Before we continue making more changes, let’s first create a new Story so we can preview this component in the Storybook environment:
1touch src/components/users.stories.tsx
Now you can copy the code below to configure the Story file with our new Users component:
12import { ComponentStory, ComponentMeta } from '@storybook/react'34import { Users } from './users'56export default {7 title: 'Components/Users',8 component: Users,9} as ComponentMeta<typeof Users>1011const Template: ComponentStory<typeof Users> = (args) => <Users {...args} />1213export const Default = Template.bind({})
It’s time to run our Storybook development environment and see our component being rendered:
1npm run storybook
Now we’re going to update the component to make an HTTP request to an API to fetch some fake users’ data to replace our current static users’ list.
The API that we are going to use is called JSONPlaceholder, and more information about it can be found here.
To make the HTTP request, we will use the browser Fetch API. We will also need to store the data coming from the API in our React component. For that, we will use React’s useState hook to manage our reactive state and the useEffect hook to integrate our async HTTP request code into React.
For more information on making an HTTP request inside React, you can check this documentation.
Here’s what our src/components/users.tsx component looks like with the API request in place:
1import { useEffect, useState } from 'react'23type User = {4 id: number5 name: string6}78export const Users: React.FC = () => {9 const [users, setUsers] = useState<User[]>([])1011 useEffect(() => {12 fetch('https://jsonplaceholder.typicode.com/users')13 .then((res) => res.json())14 .then((result: User[]) => {15 setUsers(result)16 })17 .catch(console.error)18 }, [])1920 return (21 <div>22 <h1>Users</h1>23 <ul>24 {users.map((user) => (25 <li key={user.id}>{user.name}</li>26 ))}27 </ul>28 </div>29 )30}
We fetch the users’ data from the JSONPlaceholder API and then save it to the users’ state variable by calling the setUsers method with the response result.
Preview of the Users component with data coming from the JSONPlaceholder API
Now we’re rendering the users that the JSONPlaceholder API returned, but what if the API request simply fails?
We can trigger this scenario by making our browser behave in an offline manner if we switch the network condition to offline on the developer tools. The following example is on the Brave Browser, which is Chromium-based, so others Like Google Chrome, Microsoft Edge, Opera, etc. should be verified as similar:
We get some errors on the browser console saying there's no internet connection, which we intended to do.
This is where a mock server can help us developers stay productive by giving us a way to mock our data requirements in order for us to keep developing the component UI first and deal with this sort of scenario afterward.
Install MSW
1npm install msw@^0.36.0 --save-dev2npx msw init public/ --save
This will install the MSW package as a dev dependency on the project, and then it will copy over a service worker file called mockServiceWorker.js to the public folder on the root of the repository.
Notice that we install a specific version of MSW to be 100% compatible with the rest of the tutorial.
Mocking external API
To define which requests should be mocked, we will use request handler functions. They allow us to capture any request based on its method, URL, or other criteria and specify which response to return.
1mkdir src/mocks2touch src/mocks/handlers.ts
The handlers from this module can be reused for both browser and Node in the further steps of this tutorial.
1import { rest } from 'msw'23export const handlers = [4 rest.get('https://jsonplaceholder.typicode.com/users', (req, res, ctx) => {5 return res(6 ctx.delay(),7 ctx.status(200),8 ctx.json([9 { id: 1, name: 'Leanne Graham' },10 { id: 2, name: 'Ervin Howell' },11 { id: 3, name: 'Clementine Bauch' },12 { id: 4, name: 'Patricia Lebsack' },13 { id: 5, name: 'Chelsey Dietrich' },14 { id: 6, name: 'Mrs. Dennis Schulist' },15 { id: 7, name: 'Kurtis Weissnat' },16 { id: 8, name: 'Nicholas Runolfsdottir V' },17 { id: 9, name: 'Glenna Reichert' },18 { id: 10, name: 'Clementina DuBuque' },19 ])20 )21 }),22]
Now that we have a mock for the JSONPlaceholders API users endpoint, we need a way to use it inside the Storybook environment.
Setup MSW for Storybook
We can now set up our Storybook environment to initialize MSW on page load. To integrate MSW into Storybook, a package called msw-storybook-addon makes this process a breeze.
Let’s start by installing the package itself:
1npm install msw-storybook-addon --save-dev
We can now configure Storybook with the package installed to initialize the service worker when loading Stories. Let’s update the .storybook/preview.js file to look something like:
1import { initialize, mswDecorator } from 'msw-storybook-addon'2import { handlers } from '../src/mocks/handlers'3import '../src/index.css'45initialize({ onUnhandledRequest: 'bypass' });67export const decorators = [mswDecorator];89export const parameters = {10 actions: { argTypesRegex: '^on[A-Z].*' },11 controls: {12 matchers: {13 color: /(background|color)$/i,14 date: /Date$/,15 },16 },17 msw: { handlers },18}
We added the import statements for the msw-storybook-addon package as well for the MSW handlers variables that we created in the previous step.
We start the service worker on line 5 and pass the configuration option onUnhandledRequest with the value bypass, so we don't have warnings on the console regarding HTTP requests not being handled by MSW.
On line 7, we define a global decorator that integrates seamlessly with our Story files for when we want to configure specific MSW handlers for specific stories.
Last but not least, on line 17, we configure our global handlers. This way, we don’t need to add the handlers to a specific story, as it will be loaded automatically.
We need to do one more thing before testing our mocks in Storybook. We talked about a service worker being initialized, but where is this service worker code available? The service worker file was generated into the public folder from the step where we installed the MSW package.
Assets in this directory will be served by Vite at the root path / during development and copied to the root of the dist directory as-is when building. To get the same behavior on Storybook, we need to update the .storybook/main.js file to serve the public folder assets as static files as well:
1module.exports = {2 "stories": [3 "../src/**/*.stories.mdx",4 "../src/**/*.stories.@(js|jsx|ts|tsx)"5 ],6 "addons": [7 "@storybook/addon-links",8 "@storybook/addon-essentials"9 ],10 "core": {11 "builder": "storybook-builder-vite"12 },13 "staticDirs": ["../public"], // this line was added14}
Now we can restart our Storybook development server and check if the MSW is being initialized correctly:
1npm run storybook
After opening the Storybook on the browser and checking the console, we can see a log message saying [MSW] Mocking enabled. which means our MSW setup for Storybook was successful. You can also see another log right after with a message like [MSW] GET https://jsonplaceholder.typicode.com/users (200 OK) that tells us a request to the https://jsonplaceholder.typicode.com/users URL was intercepted correctly.
This is exactly the result we were expecting, but so far, everything is working as it was before installing and setup MSW. It’s time to test the scenario that we tested before, where we switched the network condition to offline on the developer tools:
As you can see on the screenshot above, even after forcing the browser to be offline 🎉, the mock server still works, and the Users component still gets the users’ data that we configured on the handlers file.
This is a big deal as developers can mock our data requirements and keep developing components in total isolation.
Also, remember the issue we talked previously about when we tried to deploy our design system, and then the mock server wasn’t available? This issue is now gone because the mock server powered by MSW will be bundled when we build the Storybook project. This means that when we deploy the Storybook statically built assets, MSW will also be a part of it, and it will work the same way it does when developing locally.
Let’s test this by building our Storybook project first:
1npm run build-storybook
Now there is a storybook-static folder on the root of the repository that can be served with any static HTTP server; for this example, we will use the http-server package:
1npx http-server ./storybook-static/
This will start a static HTTP server serving our Storybook-built assets. Now we can visit http://localhost:8080 to view our stories.
Everything’s working exactly the way it did when running with the development server! One last test just for good measure — let’s set the browser’s network to be offline and see if we still get the mock data users to be rendered on the Users component.
And with no surprise, it still works. 🎉
Before continuing with the tutorials, let's update the .gitignore file to ignore the storybook-static folder, so we don’t accidentally commit generated files to our repository
1node_modules2.DS_Store3dist4dist-ssr5*.local6storybook-static # this line as added
Setup MSW for the development environment
With our Storybook environment being 100% to be used with MSW, it’s time to move on to the front-end development server.
We already did a couple of steps required to use MSW with our development environment. One being installing MSW and the other being adding the request handlers. With these both out of the way, we need to initialize the MSW service worker when we load pages with our development server.
To initialize the MSW service worker, we need to configure the worker following this documentation. Let's create a file in our mocks directory (src/mocks) where we would configure and start our service worker.
1touch src/mocks/browser.ts
In the browser.ts file, we are going to create a worker instance with our request handlers defined earlier.
1import { setupWorker } from 'msw'2import { handlers } from './handlers'34export const worker = setupWorker(...handlers)
For our mocks to execute during the runtime, it needs to be imported into our application's code. However, since mocking is a development-oriented technique, we will be importing our src/mocks/browser.ts file conditionally, depending on the current environment.
It's not recommended to include Mock Service Worker in production. Doing so may lead to a distorted experience for your users.
Import the src/mocks/browser.ts file conditionally on the src/main.tsx file:
12import React from 'react'3import ReactDOM from 'react-dom'4import './index.css'5import { App } from './App'67async function prepare() {8 if (process.env.NODE_ENV === 'development') {9 const { worker } = await import('./mocks/browser')10 return worker.start({ onUnhandledRequest: 'bypass' })11 }12 return Promise.resolve()13}1415prepare()16 .then(() => {17 ReactDOM.render(18 <React.StrictMode>19 <App />20 </React.StrictMode>,21 document.getElementById('root')22 )23 })24 .catch(console.error)
The prepare function was added to import the browser.ts file dynamically only when we are in development mode.
We can now run the development server and see if the MSW service worker gets initialized properly:
1npm run dev
After opening http://localhost:3000 on the browser and checking the console, we should see a log with [MSW] Mocking enabled. just like we saw when we set up MSW for Storybook.
With our mock server ready to be used on the development server, let’s import the Users component and render it on the page by updating the src/App.tsx file:
1import logo from './logo.svg'2import { Users } from './components/users'3import './App.css'45export const App: React.FC = () => {6 return (7 <div className="app">8 <header className="app-header">9 <img src={logo} className="app-logo" alt="logo" />10 <p>Hello Vite + React!</p>11 <Users />12 </header>13 </div>14 )15}
As you can see, the request handler for the https://jsonplaceholder.typicode.com/users endpoint was called successfully. 🎉
The MSW is now ready to mock any network request you need!
Setup MSW for the Jest environment
Our project has a couple of test environments configured, one being Jest and the other being Cypress. It would be awesome to use MSW on these environments as well.
Previously we set up MSW to run on Storybook and development server, which are both browser environments, but Jest is a Node environment. Thankfully, MSW handlers can be used on both browsers and Node environments!
To integrate MSW handlers into a Node environment, we need to configure a server for it first. Let's create a file in our mock definition directory (src/mocks) where we would configure our request mocking server:
1touch src/mocks/server.ts
In the server.ts file, we will create a server instance with our request handlers defined earlier.
1import { setupServer } from 'msw/node'2import { handlers } from './handlers'34export const server = setupServer(...handlers)
With our mock server ready for Node environments, we can start to integrate with our Jest configuration.
We can create a custom setup module and reference it using Jest's setupFilesAfterEnv option in your jest.config.js file. Let’s create a jest.setup.js test setup file:
1touch jest.setup.js
1const { server } = require('./src/mocks/server')23// Establish API mocking before all tests.4beforeAll(() => server.listen())56// Reset any request handlers that we may add during the tests,7// so they don't affect other tests.8afterEach(() => server.resetHandlers())910// Clean up after the tests are finished.11afterAll(() => server.close())
Now we need to reference this test setup file in the jest.config.js file:
1module.exports = {2 preset: 'ts-jest',3 testMatch: ['**/src/**/?(*.)+(spec|test).[jt]s?(x)'],4 moduleNameMapper: {5 '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$':6 '<rootDir>/__mocks__/fileMock.js',7 '\\.(css|less|scss|sass)$': 'identity-obj-proxy',8 },9 testEnvironment: 'jest-environment-jsdom',10 setupFilesAfterEnv: ['./jest.setup.js'], // this line was added11}
Let’s try running the tests and see if every still works:
1npm run test
We get an error when executing the renders hello message test:
1● renders hello message23 ReferenceError: fetch is not defined45 10 |6 11 | useEffect(() => {7 > 12 | fetch('https://jsonplaceholder.typicode.com/users')8 | ^9 13 | .then((res) => res.json())10 14 | .then((result: User[]) => {11 15 | setUsers(result)1213 at src/components/users.tsx:12:514 at invokePassiveEffectCreate (node_modules/react-dom/cjs/react-dom.development.js:23487:20)15 at HTMLUnknownElement.callCallback (node_modules/react-dom/cjs/react-dom.development.js:3945:14)16 at HTMLUnknownElement.callTheUserObjectsOperation (node_modules/jsdom/lib/jsdom/living/generated/EventListener.js:26:30)17 at innerInvokeEventListeners (node_modules/jsdom/lib/jsdom/living/events/EventTarget-impl.js:338:25)18 at invokeEventListeners (node_modules/jsdom/lib/jsdom/living/events/EventTarget-impl.js:274:3)19 at HTMLUnknownElementImpl._dispatch (node_modules/jsdom/lib/jsdom/living/events/EventTarget-impl.js:221:9)20 at HTMLUnknownElementImpl.dispatchEvent (node_modules/jsdom/lib/jsdom/living/events/EventTarget-impl.js:94:17)21 at HTMLUnknownElement.dispatchEvent (node_modules/jsdom/lib/jsdom/living/generated/EventTarget.js:231:34)22 at Object.invokeGuardedCallbackDev (node_modules/react-dom/cjs/react-dom.development.js:3994:16)23 at invokeGuardedCallback (node_modules/react-dom/cjs/react-dom.development.js:4056:31)24 at flushPassiveEffectsImpl (node_modules/react-dom/cjs/react-dom.development.js:23574:9)25 at unstable_runWithPriority (node_modules/scheduler/cjs/scheduler.development.js:468:12)26 at runWithPriority$1 (node_modules/react-dom/cjs/react-dom.development.js:11276:10)27 at flushPassiveEffects (node_modules/react-dom/cjs/react-dom.development.js:23447:14)28 at Object.<anonymous>.flushWork (node_modules/react-dom/cjs/react-dom-test-utils.development.js:992:10)29 at act (node_modules/react-dom/cjs/react-dom-test-utils.development.js:1107:9)30 at render (node_modules/@testing-library/react/dist/pure.js:97:26)31 at Object.<anonymous> (src/App.test.tsx:6:9)3233Test Suites: 1 failed, 1 passed, 2 total34Tests: 1 failed, 1 passed, 2 total35Snapshots: 0 total36Time: 2.175 s, estimated 3 s37Ran all test suites.
The specific error message is ReferenceError: fetch is not defined, telling us the Fetch API isn’t available on the Jest Node environment. We can fix this by importing a polyfill for it. For this tutorial, we are going to use the whatwg-fetch package:
/co
1npm install whatwg-fetch --save-dev
Now let’s import this polyfill into the jest.setup.js file created earlier:
1require('whatwg-fetch') // this line was added2const { server } = require('./src/mocks/server')34// Establish API mocking before all tests.5beforeAll(() => server.listen())67// Reset any request handlers that we may add during the tests,8// so they don't affect other tests.9afterEach(() => server.resetHandlers())1011// Clean up after the tests are finished.12afterAll(() => server.close())
Let’s rerun our tests:
1npm run test
1> demo-project@0.0.0 test2> jest34 PASS src/demo.test.ts5 PASS src/App.test.tsx67Test Suites: 2 passed, 2 total8Tests: 2 passed, 2 total9Snapshots: 0 total10Time: 1.856 s, estimated 3 s11Ran all test suites.
Our tests run successfully again!
We should now assess that our mock server is indeed working by making some assertions on the App.spec.tsx file. Let's assert that the header with the text Users is being rendered and the users’ list with all 10 items being mocked by the MSW.
1import '@testing-library/jest-dom'2import { render, screen } from '@testing-library/react'3import { App } from './App'45it('renders hello message', () => {6 render(<App />)7 expect(screen.getByText('Hello Vite + React!')).toBeInTheDocument()8 expect(9 screen.getByRole('heading', { level: 1, name: 'Users' })10 ).toBeInTheDocument()11 expect(screen.getByRole('list')).toBeInTheDocument()12 expect(screen.getAllByRole('listitem')).toHaveLength(10)13})
Let’s run the tests again and see if all assertions are true:
1npm run test
We get the following error on the App.spec.tsx test file:
1Unable to find an accessible element with the role "listitem"
It's telling us that there are no <li> items being rendered when this assertion occurs. This happens because we only render our users list when we have users on the users state variable inside the React component. We make the HTTP request to fetch the users, which takes time to resolve. This is called an asynchronous task, so in sort, we are trying to assert the users' list being rendered before we even have the data (still loading) available to render the UI.
To make our tests more resilient, let’s update our Users component first to have it render a loading state until the users’ data is loaded successfully:
1// ...23export const Users: React.FC = () => {4 const [isLoading, setIsLoading] = useState(false) // this line was added5 const [users, setUsers] = useState<User[]>([])67 useEffect(() => {8 setIsLoading(true) // this line was added9 fetch('https://jsonplaceholder.typicode.com/users')10 .then((res) => res.json())11 .then((result: User[]) => {12 setUsers(result)13 })14 .catch(console.error)15 .finally(() => {16 setIsLoading(false) // this line was added17 })18 }, [])1920 return (21 <div>22 <h1>Users</h1>23 {/* we conditionally render the loading or success UI */}24 {isLoading ? (25 <div>Loading...</div>26 ) : (27 <ul>28 {users.map((user) => (29 <li key={user.id}>{user.name}</li>30 ))}31 </ul>32 )}33 </div>34 )35}
Let’s update the test file as well to assert on the loading state, and when the loading state is not present anymore, we assert on the users’ list being rendered:
1import '@testing-library/jest-dom'2import {3 render,4 screen,5 waitForElementToBeRemoved, // this line was added6} from '@testing-library/react'7import { App } from './App'89it('renders hello message', async () => { // this line was updated10 render(<App />)11 expect(screen.getByText('Hello Vite + React!')).toBeInTheDocument()12 expect(13 screen.getByRole('heading', { level: 1, name: 'Users' })14 ).toBeInTheDocument()15 const loading = screen.getByText('Loading...') // this line was added16 await waitForElementToBeRemoved(loading) // this line was added17 expect(screen.getByRole('list')).toBeInTheDocument()18 expect(screen.getAllByRole('listitem')).toHaveLength(10)19})
Setup MSW for the Cypress environment
Before we continue with the configuration of MSW for the Cypress environment, let’s update both Vite and Cypress to have the latest and greatest available for us to use:
1npm update vite cypress
This command updates Vite and Cypress to their current latest versions.
In the How to set up a front-end project with Vite, React, and TypeScript blog post, we used the Vite development server for running our Cypress tests against. A better approach would be for us to run the production version of our application when running E2E tests.
To run the production version of our application, we first need to build it by running the build command:
1npm run build
After our application is built, we can serve it via the serve NPM script:
1npm run serve
This starts a server with our previously built assets from the build command.
1❯ npm run serve23> demo-project@0.0.0 serve4> vite preview56 > Local: http://localhost:4173/7 > Network: use `--host` to expose
Notice anything different on the URL where the production version of our project is being served? The port is now 4173 instead of 3000, like when we started the development server.
We can configure Vite to use the same port for both development and production by updating the vite.config.js file:
1import { defineConfig } from 'vite'2import react from '@vitejs/plugin-react'34export default defineConfig({5 plugins: [react()],6 preview: { port: 3000 }, // this line was added7 server: { port: 3000 }, // this line was added8})
Notice the preview and server configuration options added where the port is the same.
Let’s run the serve script again:
1npm run serve
1❯ npm run serve23> demo-project@0.0.0 serve4> vite preview56 > Local: http://localhost:3000/7 > Network: use `--host` to expose
Our production server is now running on port 3000 as well. This way, we don’t need to change our Cypress test URLs.
To seamlessly integrate MSW with Cypress, we need to make sure it plays well with the Cypress intercept API. This API enables us to spy and stub network requests and responses.
We can use a package called cypress-msw-interceptor to help us with the setup. This plugin takes the features of MSW and adapts its API to work with Cypress in a way that cy.intercept works. This plugin will start an MSW worker as part of the Cypress runner and intercept fetch requests from the tested application.
Let’s start by installing the plugin package:
1npm install cypress-msw-interceptor --save-dev
With the plugin installed, its time to import it on the cypress/support/index.ts file:
1import './commands'23import 'cypress-msw-interceptor' // this line was added
Let’s update the integration test file:
1describe('App', () => {2 it('shows the users list', () => {3 cy.interceptRequest(4 'GET',5 'https://jsonplaceholder.typicode.com/users',6 (req, res, ctx) => {7 return res(8 ctx.delay(),9 ctx.status(200),10 ctx.json([11 { id: 1, name: 'Mock User 1' },12 { id: 2, name: 'Mock User 2' },13 { id: 3, name: 'Mock User 3' },14 ]),15 )16 },17 )18 cy.visit('/')19 cy.findByRole('heading').should('have.text', 'Users')20 cy.findByText('Loading...').should('exist')21 cy.findByRole('list').should('exist')22 cy.findAllByRole('listitem').should('have.length', 3)23 })24})
Some errors are being reported by TypeScript, saying that Property 'interceptRequest' does not exist on type 'cy & EventEmitter.’ The method, in fact, exists, but as far as TypeScript is aware, it’s not. To fix this, we can extend the TypeScript declarations for the cy global variable:
1import { rest } from 'msw' // this line was added23import './commands'45import 'cypress-msw-interceptor'67// this block was added8declare global {9 namespace Cypress {10 interface Chainable {11 interceptRequest(12 method: string,13 url: string,14 responseResolver: Parameters<typeof rest.get>[1],15 alias?: string,16 ): Chainable<any>17 }18 }19}
Let’s run the E2E tests now:
1npm run cypress:open
Cypress dashboard default page
Click on the app.spec.ts integration test to start running it.
Cypress successful run for the app.spec.ts file
The Cypress test is now updated to mock the HTTP request to the JSONPlaceholder API, and you can see on the image above a list of users with the mock data that we added to the app.spec.ts file.
Both Cypress and MSW are amazing technologies; this plugin takes the features of MSW and adapts its API to work with Cypress in a way that cy.route works.
Conclusion
In many projects, waiting for the API is just not an option. And that’s why Mock Service Worker is the perfect match for all the times you need to request data from external resources. Mocks give you a seamless experience that improves your development workflow, as we’ve seen in the different strategies explored in this tutorial.
References
Rui Saraiva
Principal Engineer
Share this article
