humanwhocodesMentoss: The Fetch Mocker
If you find this useful, please consider supporting my work with a donation or nominate me for a GitHub Star.
Description
A utility for mocking out fetch() requests and responses.
Documentation
See the website.
Installation
npm install mentoss
Usage
There are two primary classes in Mentoss:
MockServer- a server implementation where you can mock out requests and responsesFetchMocker- the utility that creates a newfetch()function that calls one or moreMockServers
In general, you'll create a MockServer first and then create a FetchMocker, like this:
import { MockServer, FetchMocker } from "mentoss";
// create a new server with the given base URL
const server = new MockServer("https://api.example.com");
// simple mocked route
server.get("/foo/bar", 200);
// return specific response
server.post("/foo/baz", {
status: 200,
body: { message: "Success" },
headers: {
"Content-Type": "application/json",
},
});
// match more of the request
server.post(
{
url: "/foo/boom",
headers: {
"Content-type": "application/json",
},
body: {
test: true,
},
},
404,
);
// create a mocker that uses the server
const mocker = new FetchMocker({
servers: [server],
});
// here's your shiny new fetch() function if you want to use it directly
const { fetch } = mocker;
// or overwrite the global
mocker.mockGlobal();
// make a request
const response = await fetch("https://api.example.com/foo/bar");
// check that the request was made
assert(mocker.called("https://api.example.com/foo/bar"));
// check that all routes were called
assert(mocker.allRoutesCalled());
// clear the server to start over
server.clear();
// clear everything in the mocker (including servers)
mocker.clearAll();
Development
To work on Mentoss, you'll need:
Make sure both are installed by visiting the links and following the instructions to install.
Now you're ready to clone the repository:
git clone https://github.com/humanwhocodes/mentoss.git
Then, enter the directory and install the dependencies:
cd mentoss
npm install
After that, you can run the tests via:
npm test
Tips
Use Mentoss with Jest
Jest doesn't support ESM-only modules (like Mentoss) by default. You'll need to update how you call Jest in your package.json file to enable ESM support:
"scripts": {
- "test": "jest",
+ "test": "node --experimental-vm-modules ./node_modules/.bin/jest"
}
Read more about ESM support in the Jest documentation.
License
Copyright 2024-2025 Nicholas C. Zakas
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Prior Art
This project takes inspiration (but not code) from a number of other projects:
- Nock - HTTP server mocking and expectations library for Node.js.
- MSW (Mock Service Worker) - API mocking library for browser and Node.js.
- Fetch Mock - Mock HTTP requests made using
fetch.
License
Apache 2.0
Frequently Asked Questions
What does "Mentoss" even mean?
One day, I was sitting around thinking, "you know, I really wish there was a better fetch mocker." Then I thought, "fetch mocker" sounds a lot like "fresh maker," like the old Mentos commercial. Then I thought, you can't just name a package "fetch mocker" because it's too generic. I'd like to call it Mentos as a joke, but then I worried about the company coming after me for trademark infringement. So I figured I'd add an "s" at the end, to make "OSS" the suffix.