Discover Jest hidden feature: Automock

#jest#test#mock

The subject of this article will be about Jest and the mocks. I do not wish to advocate the use of “unit tests” here. Everyone is also free to define what is for him/her what is unitary. I just want to show you how Jest manages its mock and how automocking could be useful to you on a daily basis. It is important to know the basics of jest in order to understand the purpose of this article.

TL;DR

Jest automock is fast and will help you add test easily. Consider using automock when you always want to isolate your tests. This will simplify the use of mock by harmonizing the way they are created.

Context

For several years now, I have been working in contexts that allow time and encourage people to write tests. For more than two years now, I have been working in the technical teams of the M6 group.

We are using two “kind” of tests for our web platform:

  • “Unit tests” with Jest and automock: To test our services and components in an isolated context. Each test will only focus on a specific module considering that all the others are mocked.

  • “Feature/Functional tests” with CucumberJS and WebdriverIo: To test the product’s functionality, using user actions in a semi-real context.

The testing context is quite specific. You probably don’t have the same way of doing them. But this context explains a lot our interest in automocking. We do use mocks a lot, and Jest is automatically mocking things for us which is great.

If you are interested in the subject of testing, I can recommend this great conference by Kent C. Dodds at the last Assert(JS).

If you have listened to Kent’s talk, he proposes to do mainly integration tests.

However, by following the TDD principle, the tests are really a great development tool for me to structure my design and move forward step by step. I still have difficulty today in designing my development based on integration tests.

Moreover, by using “unit tests”, I can more easily refactor my code and thus gain more flexibility on the implementation. In my use, an implementation change in a module will only impact the associated test, unless the contract is modified.

How to ?

To activate the automock, it’s very simple. Just define this in the jest configuration.

module.exports = {
  automock: true,
}

Now, all the import you do in your tests will automatically be mocked. Therefore, you will need unmock the module you want to test. With this technique, you no longer need to define 10 lines of mock at the beginning of your file.

import dependency from 'dependency'
import { myMethod } from '../module/foo.js'

//the lines below are not necessary with automock activated
jest.mock('../module/foo.js')
jest.mock('dependency')

In the case of a React component test, all the components on which you depend will be mocked. No more risk of breaking several test files when modifying a single component.

When your module depends on asynchronous functions, you can easily stub their error or success behavior with mockResolveValue and mockRejectValue.

What happens when you call jest.mock ?

Before explaining why I love using automock, let’s see what Jest does when he is asked to mock a module.

When you use jest.mock on a module. Every exported values will be transformed like this (recursively):

  • Function will be transformed to spy function doing noop (like, the jest.fn())
  • Array will be transformed to empty array.
  • ES6 Class will be transformed like function
  • Number, Object, String won’t be affected.

To summarize, we can say that the default mock does what we would hope if we wanted to isolate our test from all existing modules.

Automock is working just like jest.mock but for all the imported module of your test. It’ll save you a lot of time.

What is great with automock ?

For me, activating Jest’s automock means taking full advantage of jest’s ability to generate a mocked version of a module.

No need to wonder if the module or dependency you are importing is mocked. Absolutely everything is mocked.

The only “noise” in your test will be from unmock the file you want to test.

Some may think that enabling this option will slow down your tests. Don’t worry about it. On the project I’m working on, we have more than 3000 tests that run in less than 4 minutes.

Tips

  • Switching to automock on a huge project with many tests will be hard and dangerous.

  • When your test behave strangely, maybe you forgot to unmock the module your are testing. It’s going to drive you crazy.

  • Try to outsource in __mocks__ files as soon as you are forced to duplicate a mock.

  • Don’t forget jest is auto mocking Array by an empty Array.

If you liked this article, don’t hesitate to share it! If you do your tests differently, share your tips with us.

Feel free to share your tips with Jest.


Written by Antoine Caron who lives and works in Lyon (France) building useful things at Bedrock. You should follow him on Twitter. Take a look at my friends websites. You could also take a look at the conferences I gave. If you want to see my professional background, my resume is available here.

If you like some content of this blog, or it has helped you, please consider donating to the Abbé Pierre Foundation which I personally support.
"We are only ever happy in the happiness we give. To give is to receive."