Testing in TypeScript: Frameworks and Tools

Testing in TypeScript: Frameworks, Tools, and Best Practices

TypeScript is a statically typed superset of JavaScript that is actively used in modern web projects. However, typing alone does not guarantee the absence of logical errors, runtime bugs, or incorrect component behavior. Therefore, testing TypeScript applications is a mandatory stage of development. In this article, we will thoroughly examine the main frameworks and tools for testing TypeScript, their features, usage examples, and recommendations for selection.

1. Why is testing TypeScript different from JavaScript?

TypeScript adds static type checking, but this does not replace unit tests, integration tests, or E2E tests. However, TypeScript provides advantages:

Type safety — the compiler catches many errors at the development stage.
Better IDE support — autocompletion, refactoring, navigation.
Cleaner test code — types help avoid bugs in the tests themselves.

At the same time, frameworks for testing TypeScript typically work through transpilation (ts-jest, esbuild, swc) or use built-in TypeScript support.

2. Main frameworks for unit testing

Jest

The most popular framework for testing JavaScript and TypeScript. Supported by Facebook, it has a built-in assertion library, mocks, spies, and code coverage.

Installation and setup:

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

Configuration in jest.config.ts:

export default {  preset: 'ts-jest',  testEnvironment: 'node',  roots: ['<rootDir>/src']};

Example test:

// sum.tsexport function sum(a: number, b: number): number {  return a + b;}

// sum.test.tsimport { sum } from './sum';

describe('sum function', () => {  it('should add two numbers correctly', () => {    expect(sum(2, 3)).toBe(5);  });

  it('should handle negative numbers', () => {    expect(sum(-1, -2)).toBe(-3);  });});

Vitest

A modern alternative to Jest, optimized for Vite projects. It stands out for its high speed due to using esbuild/swc under the hood. Fully compatible with TypeScript out of the box.

Installation:

npm install --save-dev vitest

Example test (without additional configuration):

// utils.tsexport const capitalize = (str: string): string => {  return str.charAt(0).toUpperCase() + str.slice(1);};

// utils.test.tsimport { describe, it, expect } from 'vitest';import { capitalize } from './utils';

describe('capitalize', () => {  it('should capitalize first letter', () => {    expect(capitalize('hello')).toBe('Hello');  });

  it('should handle empty string', () => {    expect(capitalize('')).toBe('');  });});

Mocha + Chai

A classic duo for flexible testing. Mocha is a test runner, Chai is an assertion library. Requires additional setup for TypeScript.

Installation:

npm install --save-dev mocha chai @types/mocha @types/chai ts-node typescript

Example:

import { expect } from 'chai';import { describe, it } from 'mocha';

function multiply(a: number, b: number): number {  return a * b;}

describe('multiply', () => {  it('should multiply two numbers', () => {    expect(multiply(3, 4)).to.equal(12);  });

  it('should handle zero', () => {    expect(multiply(5, 0)).to.equal(0);  });});