Jest for TypeScript: Complete Testing Guide

What is Jest and why is it needed for TypeScript?

Jest is a powerful and popular testing framework for JavaScript and TypeScript, developed by Meta (Facebook). It provides everything needed for writing unit tests, integration tests, and snapshot tests "out of the box": an assertion library, mocks, spies, timers, and code coverage. For TypeScript, Jest is especially valuable as it allows checking types during test execution, which increases code reliability. Using Jest with TypeScript helps developers find errors faster, refactor code with confidence, and maintain high project quality.

Installation and setup

To get started, install Jest and the necessary types via npm or yarn:

npm install --save-dev jest @types/jest ts-jest typescript

Then initialize the Jest configuration:

npx ts-jest config:init

This will create a jest.config.js file with settings for TypeScript. Make sure that tsconfig.json has "module": "commonjs" set, or use ts-node for ESM.

Main features

• describe and it/test — grouping and writing tests.
• expect — assertion function with many matchers (toBe, toEqual, toContain, toThrow, etc.).
• beforeEach / afterEach — hooks for preparing and cleaning up the environment.
• jest.mock — automatic mocking of modules.
• jest.spyOn — spying on function calls.
• Snapshot testing — comparing component output.
• Code coverage — built-in --coverage utility.

Code example in TypeScript

// math.tsexport const add = (a: number, b: number): number => a + b;export const divide = (a: number, b: number): number => {  if (b === 0) throw new Error('Division by zero');  return a / b;};

// math.test.tsimport { add, divide } from './math';

describe('Math functions', () => {  test('adds two numbers correctly', () => {    expect(add(2, 3)).toBe(5);    expect(add(-1, 1)).toBe(0);  });

  test('throws error when dividing by zero', () => {    expect(() => divide(10, 0)).toThrow('Division by zero');  });

  test('divides correctly', () => {    expect(divide(10, 2)).toBe(5);    expect(divide(9, 3)).toBeCloseTo(3);  });});

When to use Jest with TypeScript?

• Any TypeScript projects — from small libraries to large applications.
• Development with TDD — Jest is great for writing tests before implementation.
• Refactoring — to ensure changes haven't broken existing logic.
• CI/CD pipelines — fast test execution and coverage checking.
• Testing React components — together with @testing-library/react.

Jest is the de facto standard for testing TypeScript, thanks to its ease of setup, rich API, and excellent integration with modern tools.