Hey 👋
Are you planning to add tests to your React codebase? You cannot find a good tutorial that can help you get started? Then you've landed on the right article. In this article, we'll cover all the steps for writing unit tests. We'll even cover the errors or issues that you might encounter when starting.
This article uses Jest and React Testing Library. It's okay if you want to use other libraries, the fundamentals in this article will help you there as well.
The code is available on GitHub, find the link in the end.
Why should you write tests?
You can develop an entire product without writing tests. Your end users don't care about it. Your Product manager doesn't care about it. Your tester/QA doesn't care about it. But you, as a developer, should! 🤌
Imagine you've a website with thousands of users. You did some refactoring(or added a hotfix) in a common utility function. You tested the change at one place in the app, it worked fine. You deployed it on a "Friday"(rookie mistake). It broke 🔥 production over the weekend. The change you made broke the app at few other places. At this point, you wish you had some sort of tests in place that would automatically run before deploying to production.
Above-mentioned scenario is much more common than you think. You might not have faced it(yet!?), but a lot of engineers have, including me.
Few reasons why testing is important:
🚀 Helps you ship with confidence.
📜 Acts like documentation.
🛠️ Helps in debugging and refactoring.
⌛️ Reduces development time, not initially, but in the long run.
To all the junior devs looking at a promotion - add testing to your skillset. 😉
The Tutorial
We'll start from scratch, so get your terminals ready. Let's use vite
for creating a sample project.
Once the project is created, run it using the following command.
After running, you will see a demo app on the screen.
We won't add new features to this app, but we'll refactor the button into a separate component - so we can write tests for it.
Let's add two buttons on the screen:
- A button that will 2x the count when pressed.
- A button that will(in order):
- Divide by 2 if the count ends with 0.
- Add 1 if the count is a Fibonacci number.
- Square the count, otherwise.
We need to declare the functions used, in the utils
module. We've used some helper functions which are not needed outside of this module, so we'll not export them.
We're done with our setup, let's start with the tests. Instead of jumping directly into React testing, let's write tests for our utils functions first. This will help us in getting a gist of jest
in isolation.
Let's write the test for doubleTheNum
function.
The code above tests if our function works as expected. Some key components of any test are:
describe
function: The first argument is the string that will be displayed when our tests run. The second argument is the actual function that will run the tests. It is used to group similar tests. Currently, it only has 1 test but in another example you'll see it can have multiple tests inside it.it
function: The arguments are similar todescribe
function. The string argument here should state what does the function in the next argument test as clearly as possible. Alternatively, you can usetest
function instead ofit
.expect
statement: The first three lines of the function are straightforward. The last line asserts if our functiondoubleTheNum
ran correctly. It also usestoEqual
- a matcher function.
There are a lot of matchers available in jest. For exmaple:
-
toBeNull
matches onlynull
. -
toBeTruthy
matches anything that an if statement treats astrue
.
Read more about matchers here.
To run the test we need jest
installed.
Let's also add a script in package.json
to run tests.
Finally, run the tests using yarn test
.
For most of you the above steps should be enough. If you face any issues related to module imports or TypeScript. Follow these steps.
- Install and set up
@babel/preset-env
.
Add it to package.json
- Install packages for TypeScript support.
Add jest configuration in jest.config.ts
.
Run the tests again, it should work this time.
In the output, you can see the strings we used in describe
and it
function.
🎉 Congratulations on writing your first test!
Enjoying the article so far? Check out my most popular article on Redux: Just Redux: The Complete Guide with ~25K reads.
Need a break? Checkout this amazing picture from my most recent trip to Rishikesh.
More on my Instagram. 😉
Let's write the test for our funkyNum
function now.
When writing tests try to cover most of the branches and statements of a function. Better coverage gives more confidence.
If you run the tests again, you should see the following output.
Ideally, we should write a separate describe
block for isFibonacci
and isPerfectSquare
functions. In unit tests, we test code in isolation. For brevity, we didn't do it.
💡 Quick tips
- You can skip any test by calling
it.skip
ortest.skip
.describe.skip
will skip the entire block.
- You can run a single test by calling
it.only
ortest.only
.
We've covered how to test JS code using jest
. Let's dive into React testing, finally. 💪
We'll need a few packages. Let's install them.
We'll also have to add the environment in jest.config.ts
.
Now, we'll write the most basic test for CounterButton
component.
We provided the required props and tried to render the component. This should be the first test you write for any component. If it cannot render, it's of no use.
The render
function from RTL renders the provided component in document.body
.
It also returns some query methods like getByText
that can be used to find elements in the DOM.
List of all the query methods is available here.
If you run the tests again, you should see 2 suites - all green and passing.
The second test we'll write will test the component against the props. You should test for each prop separately, if they are independent.
The getByText
is a query method that helps us grab an element by using a string.
The toBeInTheDocument
method is matcher just like toEqual
. It doesn't come with jest
by default. It comes from the package we installed earlier - @testing-library/jest-dom
.
There are different packages for different environments like @testing-library/jest-native
for React Native.
If you run the test again, it should be passing.
Finally, we have come to the final test of this article and it's an important one. We'll write a test to check if the click handler works as expected.
To generate user events like clicking and typing, we'll need another package.
It looks almost same, with some minor differences.
Notice how the function is now async
because of the user event.
On the very first line, jest.fn()
is a mock function that tracks a lot of things useful in testing like the number of times it was called, the arguments it was called with, etc. You'll see a lot of these out there.
We've also used a new query method getByRole
to find the button element.
We wait for the click event to occur before checking if our mock function was called.
That's it! If you run the tests, they should pass.
🔗 You can find all the code here.
👀 What's next?
If you were able to follow through the article, you can start writing tests in your codebase and explore further.
Some keys topics I'd suggest after this are:
-
getByTestId
- This is a common query method that you'll see out there. When nothing works, this will. - Learn about Setup and Teardown methods. It will level up your testing game.
- Learn how to mock npm modules, API calls, global state, context, etc.
If you liked the article, consider sharing it with others. 🤝
I write detailed articles on such topics, feel free to connect with me on LinkedIn or X. 🙏
Top comments (8)
Hi , Sanjeev Sharma
I am the editor of InfoQ China which focuses on software development. We like your articles and plan to translate one of them entitled “Writing your first Unit Test in React".
Before we translate it into Chinese and publish it on our website, I want to ask for your permission first! This translation version is provided for informational purposes only, and will not be used for any commercial purpose.
In exchange, we will put the English title and link at the end of Chinese article. If our readers want to read more about this, he/she can click back to your website.
Thanks a lot, hope to get your help. Any more question, please let me know.
Hello 许学文,
Sure. Go ahead. Please share the article link here once it's published. :)
I apologize for the late response. Below is the link to the translation. Thank you once again for your authorization.
infoq.cn/article/1ypo54cMidb7PzRpxowD
very informative 👏
glad you liked it :)
This is not unit testing. This maybe confusing, since the test runner is the same.
The moment you start to render anything this is component testing and not more/mere unit testing.
The difference:
Interesting take.
"A software development process in which the smallest testable parts of an application, called units, are individually scrutinized for proper operation."
I see Unit Testing by this definition.
And even on google search, all results on React testing talk about the same stuff I mentioned.
I think "Running time" of a test doesn't make it a unit test. Sure, they should be fast but that's not a compulsion.
Testing static state/props in a components is obviously not very helpful.
Example: to test if a components includes a text "Count is: " is not really useful, since you just "cement" or "pin down" the code and makes you to have to modify code at 2 places at once in each future changes / implementation of new features.
If you test your components, then you obviously want to test some of its logic and/or state transition. Writing your logic inside components instead of writing them in separate functions is obviously a bad choice (if it isn't completely trivial). If you separate your logic, then it is the smallest testable part of the application. Hence unit tests exclude component (rendering) tests.
Running time -> is for increased developer experience. I hope you care for your developer experience?
Have you worked at a big corp, where tests take 30min - 4h?
I can spare you the experience and say that it sucks completely, especially if you touch things that are imported and used in 300+ places at once.
"all results on React testing talk" - Its because of the wrong terminology.
Component-rendering tests can't be the smallest unit, because you do not want to test the rendering. Testing rendering makes only sense if you participate in and advance the development of React itself.