Test your React Apps with Vitest

Test your React Apps with Vitest

Unlock Faster, More Efficient Testing in Your React Projects with Vitest.

What is React Testing? 🤔

React testing refers to the process of verifying the functionality and performance of React components and applications. It involves simulating user interactions, validating component outputs, and ensuring that the application behaves as expected under various conditions.

Testing Frameworks in the React Ecosystem 🛠️

  • Jest: A comprehensive testing solution developed by Facebook that provides built-in test runners, assertion libraries, and mocking support. Jest is widely used for its simplicity and support for snapshot testing.
  • Mocha: Another powerful testing framework that is flexible and configurable, with a rich plugin ecosystem. Mocha requires an assertion library like Chai to be fully functional.
  • Enzyme: A testing utility developed by Airbnb for React applications. Enzyme makes it easier to assert, manipulate, and traverse your React Components' output.
  • React Testing Library: Part of the Testing Library family, it provides light utility functions on top of React DOM and React DOM Test Utils, encouraging better testing practices by focusing on component outputs rather than implementation details.

Why Vitest? 🚀

Speed and Efficiency

Vitest is designed from the ground up to take advantage of Vite's fast module reloading, resulting in significantly quicker test runs. This speed is further enhanced by parallel test execution and efficient caching, making Vitest an excellent choice for large projects.

Jest Compatibility

For teams already familiar with Jest, Vitest offers an easy transition path. Its API is compatible with Jest, meaning that in many cases, tests can be migrated with minimal changes. This compatibility allows teams to leverage Vitest’s performance benefits without a steep learning curve.

Modern JavaScript Support

Vitest is built with modern JavaScript frameworks in mind. It supports ES modules natively, allowing for straightforward configuration and integration into projects that use modern JavaScript features and syntax. This makes it particularly well-suited for projects using Vite as their build tool.

Rich Feature Set

Vitest doesn’t compromise on features for the sake of speed. It includes a full suite of testing utilities, including snapshot testing, test coverage, mocking, and assertions.

Getting Started with Vitest in a React Project

To integrate Vitest into your React project, you’ll first need to ensure that your project is set up with Vite. Once that’s in place, follow these steps to add Vitest:

  1. Installation: Begin by installing Vitest along with the required testing libraries. You can do so by running:

npm  install  vitest  react-testing-library  @testing-library/jest-dom  --save-dev
  1. Configuration: Next, configure Vitest to work with your React components. Create a vite.config.ts file (or modify the existing one) to include Vitest’s plugin:
import { defineConfig } from "vite";

import react from "@vitejs/plugin-react";

import { viteSingleFile } from "vite-plugin-singlefile";

import { visualizer } from "rollup-plugin-visualizer";

import { defineConfig } from "vitest/config";

export default defineConfig({
  plugins: [react(), viteSingleFile(), visualizer()],

  test: {
    // Vitest configuration options

    globals: true,

    environment: "jsdom",
  1. Writing Your First Test: With Vitest configured, it’s time to write your first test. For example, if you have a simple Button component, you can test it like this:
import { describe, it, expect } from "vitest";

import { render, screen } from "@testing-library/react";

import Button from "../Button";

describe("Button", () => {
  it("renders correctly", () => {
    render(<Button>Click me</Button>);

    expect(screen.getByRole("button")).toHaveTextContent("Click me");

This test renders the Button component and asserts that it contains the correct text.

  1. Running Tests: To run your tests, add a script to your package.json:

"scripts": {

"test":  "vitest"


Then, execute npm run test in your terminal. Vitest will run the tests and provide you with instant feedback.

Component Testing with Vitest

Component testing focuses on testing the behavior of React components in isolation. Let's test a TodoItem component that displays a todo's text and a checkbox to mark the todo as completed.

TodoItem Component:

function TodoItem({ todo, onToggle }) {
  return (
        onChange={() => onToggle(todo.id)}

Test for TodoItem Component:

import { describe, it, expect } from "vitest";
import { render, fireEvent, screen } from "@testing-library/react";
import TodoItem from "../components/TodoItem";

describe("TodoItem", () => {
  it("displays the todo and reacts to the checkbox toggle", async () => {
    const mockToggle = vitest.fn();
    const todo = { id: 1, text: "Learn Vitest", completed: false };

    render(<TodoItem todo={todo} onToggle={mockToggle} />);

    // Check if the todo text is displayed
    expect(screen.getByText("Learn Vitest")).toBeInTheDocument();

    // Toggle the checkbox

Unit Testing with Vitest

Unit testing involves testing the smallest parts of an application in isolation (e.g., functions). Let's test a simple utility function that filters completed todos.

filterCompletedTodos Function:

function filterCompletedTodos(todos) {
  return todos.filter((todo) => todo.completed);

Test for filterCompletedTodos Function:

import { describe, it, expect } from "vitest";
import { filterCompletedTodos } from "../utils/todoUtils";

describe("filterCompletedTodos", () => {
  it("filters completed todos correctly", () => {
    const todos = [
      { id: 1, text: "Learn React", completed: false },
      { id: 2, text: "Learn Vitest", completed: true },

    const filtered = filterCompletedTodos(todos);

Testing Hooks with Vitest

Testing React hooks allows you to ensure your custom hooks behave as expected. Let's test a custom hook useCounter that provides functionality to increment, decrement, and reset a counter.

useCounter Hook:

import { useState } from "react";

function useCounter(initialValue = 0) {
  const [count, setCount] = useState(initialValue);

  const increment = () => setCount(count + 1);
  const decrement = () => setCount(count - 1);
  const reset = () => setCount(initialValue);

  return { count, increment, decrement, reset };

Test for useCounter Hook:

To test custom hooks, we can use the @testing-library/react-hooks library, which enables you to render hooks in a testing environment.

import { describe, it, expect } from "vitest";
import { renderHook, act } from "@testing-library/react-hooks";
import useCounter from "../hooks/useCounter";

describe("useCounter", () => {
  it("should use counter", () => {
    const { result } = renderHook(() => useCounter());


    act(() => {


    act(() => {


    act(() => {


  it("should accept initial count", () => {
    const { result } = renderHook(() => useCounter(10));


For more detailed information on Vitest, refer to the official documentation.