Some days your code flows, your fingers fly, and you’re god amongst nerds. Other days you’re testing
So I’m writing this to save you some time. The definitive how to mock and test fetch requests guide for 2020.
First, a little background
Why even test requests?
Integration testing. Also known as the only useful testing. 😛
Semantics aside, most bugs happen on the edges. The touch points between systems. Interfaces between modules.
What bigger in-between point than calling an API? Lots can go wrong. Server can fail, network down, strange response codes, or just corruption on the wire.
Take for example this
isAuthenticated method from a library I built at work.
Is the user authenticated? Check local cookies. That’s always gonna work.
And if cookies look correct, you gotta ask the server if they’re actually correct. User might have been banned, deleted, access revoked, or just changed their password.
That API request is the most likely failure point.
Wanna really test this method? Gonna have to test the fetch.
Why mock fetch requests?
A pure unit testing approach says you should never mock requests to other systems.
You assume the request works and test that your function makes the request. Then you test the function that’s called after the fetch.
And you enter the unit testing fallacy.
Besides, structuring your code to allow a pure unit testing approach makes it harder to read, understand, and tedious to work with. You’d need something like this:
Yeah that’s not gonna get out of hand 🙄
Keep your code simple and mock the request instead. Hook into the
fetch() API and manipulate what it returns. That is the way to testing bliss my friend.
How to mock fetch requests in Jest
After more hours of trial and error than I dare admit, here’s what I found: You’ll need to mock the
fetch method itself, write a mock for each request, and use a fetch mocking library.
The library that worked best for me was
You tell Jest to use a mock library like this:
Jest imports this file instead of
isomorphic-fetch when running your code. Same approach works to replace any other library.
Put a file of <library name> in
src/__mocks__ and that file becomes said library. In this case we’re replacing the
isomorphic-fetch library with a
So when your code says
It’s actually getting the sandbox 🤘
You’ll need to import a fetch to support mocking – can’t rely on the global
window.fetch I’m afraid. You can’t use that in test environments anyway since it doesn’t exist.
Using TypeScript in tests, you’ll have to jump through another hoop: TypeScript doesn’t understand that isomorphic-fetch is mocked and gets confused.
You have to tell the type system that “Hey, this is actually fetch-mock. All is well.”
Convoluted but how else is TypeScript supposed to know
isomorphic-fetch is actually
And now it works ✌️
All you gotta do now is mock a request and write your test.
Each of those tests is saying “When you fetch() this URL, return this object. No network calls are made, no servers harmed, no ambiguity about what happens. Just solid tests doing exactly what you want.
And now you know your code works. Bliss 😌
Learned something new? Want to improve your skills?
Join over 10,000 engineers just like you already improving their skills!
Here's how it works 👇
PS: You should also follow me on twitter 👉 here.
It's where I go to shoot the shit about programming.