DEV Community

Cover image for Jest Explained: Write Your First JavaScript Test in 10 Minutes
Synfinity Dynamics Pvt Ltd
Synfinity Dynamics Pvt Ltd

Posted on

Jest Explained: Write Your First JavaScript Test in 10 Minutes

Your JavaScript code works today, but how do you know it won't break after the next update? That's where automated testing comes in.

Jest is a popular JavaScript testing framework that helps developers catch bugs, verify functions, and write more reliable code. The best part? You don't need advanced testing experience to get started.

In this beginner-friendly Jest tutorial, you'll learn what Jest is, how to install it, and how to write and run your first JavaScript test in just 10 minutes.

What Is Jest?

Jest is an open-source JavaScript testing framework developed by Meta. It helps developers write and run automated tests to check whether their code behaves as expected.

Jest is commonly used for JavaScript unit testing in Node.js, React, and other JavaScript projects. It includes built-in assertions, mocking, and test reporting, making testing easier without complicated setup.

For example, you can use Jest to verify that a function returns the correct result before deploying your application. For more practical examples, explore our Jest Testing Guide for Node.js Developers to learn how to test backend functions and improve code reliability.

Why Use Jest for JavaScript Testing?

Jest makes JavaScript testing simpler, faster, and more reliable. Its beginner-friendly features help developers catch bugs early and maintain code quality.

Here are some key benefits of using Jest:

  • Easy setup: Start testing with minimal configuration.
  • Fast test execution: Run tests efficiently and get quick feedback.
  • Built-in assertions: Use matchers like toBe() and toEqual() to verify results.
  • Mocking support: Test functions without depending on external services.
  • Clear test reports: Quickly identify passing and failing tests.

These features make Jest a practical choice for beginners learning automated testing.

How to Install Jest

Before starting this Jest tutorial, make sure Node.js and npm are installed on your computer.

Follow these steps to set up Jest:

Step 1: Create a JavaScript project

mkdir jest-demo
cd jest-demo
npm init -y
Enter fullscreen mode Exit fullscreen mode

Step 2: Install Jest

npm install --save-dev jest
Enter fullscreen mode Exit fullscreen mode

Step 3: Configure the test script

Open package.json and update the scripts section:

"scripts": {
  "test": "jest"
}
Enter fullscreen mode Exit fullscreen mode

That's it! Your project is ready for Jest testing. Next, you'll write a simple JavaScript function and test it. As you build your JavaScript skills, you can also explore JavaScript ES2026 to learn about the latest language features and how they can improve your development workflow.

Write Your First Jest Test

Now that Jest is installed, let's write your first Jest test example using a simple addition function.

Step 1: Create a JavaScript function

Create a file named sum.js and add:

function sum(a, b) {
  return a + b;
}

module.exports = sum;
Enter fullscreen mode Exit fullscreen mode

Step 2: Create a test file

Create sum.test.js in the same folder:

const sum = require('./sum');

test('adds 2 + 3 to equal 5', () => {
  expect(sum(2, 3)).toBe(5);
});
Enter fullscreen mode Exit fullscreen mode

Step 3: Understand the test

  • test() defines what you're testing.
  • expect() checks the actual result.
  • toBe() compares the result with the expected value.

Here, Jest verifies whether sum(2, 3) returns 5. If the values match, the test passes. Otherwise, Jest reports a failure.

You've now written your first JavaScript unit test!

Run Your Jest Test and Understand the Results

Now it's time to run your first Jest test. Open your terminal in the project folder and enter:

npm test
Enter fullscreen mode Exit fullscreen mode

Jest automatically finds sum.test.js and executes the test.

If everything works correctly, you'll see an output similar to this:

PASS  ./sum.test.js
✓ adds 2 + 3 to equal 5

Test Suites: 1 passed, 1 total
Tests:       1 passed, 1 total
Enter fullscreen mode Exit fullscreen mode

What happens if the test fails?

Change the expected value from 5 to 6 and run the test again. Jest will display a failure showing the expected and received values.

This makes it easier to identify bugs and verify that your JavaScript functions work as intended. If you're new to backend development, our guide on Getting Started with Node.js in 2026 can help you understand the fundamentals before building and testing Node.js applications.

Common Jest Mistakes to Avoid

Even a simple Jest tutorial for beginners can involve a few common mistakes. Here's what to watch out for:

  • Incorrect test filenames: Use names like sum.test.js so Jest can discover your tests.
  • Missing test script: Make sure "test": "jest" is configured in package.json.
  • Wrong expected values: Double-check your assertions when a test fails.
  • Confusing matchers: Use toBe() for primitive values and toEqual() for comparing objects or arrays.

Avoiding these mistakes will make your JavaScript testing experience smoother and help you debug problems faster.

Conclusion

Getting started with Jest doesn't have to be complicated. In this Jest tutorial, you learned how to install Jest, write your first JavaScript test, and understand passing and failing results.

Automated testing helps developers catch bugs early, improve code quality, and build more reliable applications. Start by testing simple functions, then gradually explore advanced Jest features as your projects grow.

FAQs

1. Is Jest good for beginners?

Yes, Jest is beginner-friendly because it offers simple syntax, built-in assertions, and clear test results. Developers can start writing JavaScript tests with minimal configuration.

2. Can I use Jest with Node.js?

Yes, Jest works with Node.js applications. You can use it to test JavaScript functions, backend logic, APIs, and asynchronous operations.

3. What is the difference between Jest and Vitest?

Both are JavaScript testing frameworks. Jest is widely used in JavaScript projects, while Vitest is designed to integrate closely with Vite-based development workflows.

4. Does Jest support automated testing?

Yes, Jest automatically discovers and runs test files. It supports unit testing, mocking, and asynchronous tests to help developers identify bugs and maintain code quality.

Top comments (0)