Pruebas en TypeScript: frameworks y herramientas

Pruebas en TypeScript: frameworks, herramientas y mejores prácticas

TypeScript es una extensión de JavaScript con tipado estático que se utiliza activamente en proyectos web modernos. Sin embargo, la tipificación por sí sola no garantiza la ausencia de errores lógicos, bugs en tiempo de ejecución o un funcionamiento incorrecto de los componentes. Por lo tanto, las pruebas de aplicaciones TypeScript son una etapa obligatoria del desarrollo. En este artículo, analizaremos en detalle los principales frameworks y herramientas para probar TypeScript, sus características, ejemplos de uso y recomendaciones para elegir.

1. ¿Por qué las pruebas en TypeScript son diferentes de JavaScript?

TypeScript añade verificación estática de tipos, pero esto no reemplaza las pruebas unitarias, las pruebas de integración o las pruebas E2E. Sin embargo, TypeScript ofrece ventajas:

Seguridad de tipos — el compilador detecta muchos errores durante el desarrollo.
Mejor soporte del IDE — autocompletado, refactorización, navegación.
Limpieza del código de pruebas — los tipos ayudan a evitar bugs en las propias pruebas.

Además, los frameworks para probar TypeScript generalmente funcionan mediante transpilación (ts-jest, esbuild, swc) o utilizan soporte integrado para TypeScript.

2. Principales frameworks para pruebas unitarias

Jest

El framework más popular para probar JavaScript y TypeScript. Es mantenido por Facebook, tiene una librería de aserciones integrada, mocks, espías y cobertura de código.

Instalación y configuración:

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

Configuración en jest.config.ts:

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

Ejemplo de prueba:

// 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

Un análogo moderno de Jest, optimizado para proyectos Vite. Se destaca por su alta velocidad de ejecución gracias al uso de esbuild/swc internamente. Es totalmente compatible con TypeScript desde el primer momento.

Instalación:

npm install --save-dev vitest

Ejemplo de prueba (sin configuración 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('should capitalize first letter', () => {    expect(capitalize('hello')).toBe('Hello');  });

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

Mocha + Chai

Un dúo clásico para pruebas flexibles. Mocha es el test runner, Chai es la librería de aserciones. Requiere configuración adicional para TypeScript.

Instalación:

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

Ejemplo:

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);  });});