Testes em TypeScript: frameworks e ferramentas

Testes em TypeScript: frameworks, ferramentas e melhores práticas

TypeScript é uma extensão estaticamente tipada do JavaScript, amplamente utilizada em projetos web modernos. No entanto, a tipagem por si só não garante a ausência de erros lógicos, bugs em tempo de execução ou mau funcionamento dos componentes. Portanto, testar aplicações TypeScript é uma etapa obrigatória do desenvolvimento. Neste artigo, analisaremos detalhadamente os principais frameworks e ferramentas para testar TypeScript, suas características, exemplos de uso e recomendações de escolha.

1. Por que testar TypeScript é diferente de testar JavaScript?

TypeScript adiciona verificação estática de tipos, mas isso não substitui testes unitários, testes de integração ou testes E2E. No entanto, o TypeScript oferece vantagens:

Segurança de tipos — o compilador detecta muitos erros durante o desenvolvimento.
Melhor suporte de IDE — autocompletar, refatoração, navegação.
Limpeza do código de teste — os tipos ajudam a evitar bugs nos próprios testes.

Além disso, os frameworks para testar TypeScript geralmente funcionam por meio de transpilação (ts-jest, esbuild, swc) ou usam suporte interno ao TypeScript.

2. Principais frameworks para testes unitários

Jest

O framework mais popular para testar JavaScript e TypeScript. Mantido pelo Facebook, possui biblioteca de asserções integrada, mocks, espiões e cobertura de código.

Instalação e configuração:

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

Configuração em jest.config.ts:

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

Exemplo de teste:

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

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

describe('função sum', () => {  it('deve somar dois números corretamente', () => {    expect(sum(2, 3)).toBe(5);  });

  it('deve lidar com números negativos', () => {    expect(sum(-1, -2)).toBe(-3);  });});

Vitest

Alternativa moderna ao Jest, otimizada para projetos Vite. Destaca-se pela alta velocidade de execução graças ao uso de esbuild/swc internamente. Totalmente compatível com TypeScript nativamente.

Instalação:

npm install --save-dev vitest

Exemplo de teste (sem configuração adicional):

// 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('deve capitalizar a primeira letra', () => {    expect(capitalize('hello')).toBe('Hello');  });

  it('deve lidar com string vazia', () => {    expect(capitalize('')).toBe('');  });});

Mocha + Chai

Dupla clássica para testes flexíveis. Mocha é o executor de testes, Chai é a biblioteca de asserções. Requer configuração adicional para TypeScript.

Instalação:

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

Exemplo:

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

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

describe('multiply', () => {  it('deve multiplicar dois números', () => {    expect(multiply(3, 4)).to.equal(12);  });

  it('deve lidar com zero', () => {    expect(multiply(5, 0)).to.equal(0);  });});