TDD en TypeScript: escribe código sin miedo ni reproches

Deja de adivinar: por qué TDD no es masoquismo, sino un superpoder

Imagina: escribes código. Todo funciona. Estás contento. Un mes después vuelves al proyecto, haces un pequeño cambio y todo se rompe. ¿Te suena? Ahora imagina que tienes una red de seguridad que atrapa cada error en un segundo. Eso es TDD en TypeScript — desarrollo guiado por pruebas.

Muchos desarrolladores piensan que TDD es para perfeccionistas o para proyectos de la NASA. Spoiler: no es así. Test Driven Development es una herramienta que ahorra horas de depuración, mejora la calidad del código y hace que la refactorización sea segura. En este artículo, analizaremos TDD TypeScript con ejemplos reales, sin rodeos ni abstracciones.

Si escribes en TypeScript y quieres dejar de temer tus propias modificaciones, sigue leyendo. Será interesante.

¿Qué es TDD? (y por qué no se trata solo de "escribir pruebas")

TDD (Test-Driven Development) es una metodología donde las pruebas se escriben antes que el código. ¿Suena descabellado? Solo a primera vista. El ciclo TDD consta de tres pasos:

\n
1. Rojo (Red) — escribe una prueba que fallará con certeza porque el código aún no existe.
\n
2. Verde (Green) — escribe el código mínimo para que la prueba pase.
\n
3. Refactorización (Refactor) — mejora el código sin cambiar su comportamiento.
\n

Y así, en ciclo. Cada nueva pieza de funcionalidad comienza con una prueba. Esto disciplina, obliga a pensar en el diseño de la API de antemano y da la confianza de que todo funciona como un reloj.

Por cierto, las pruebas unitarias TypeScript no son solo "verificar funciones". Son documentación, especificación y seguro en un solo paquete.

Herramientas para TDD en TypeScript: qué instalar

Para testing TypeScript necesitaremos:

\n
• Jest — el framework de pruebas más popular. Funciona de serie con TypeScript.
\n
• ts-jest — un preset para Jest para que entienda TypeScript sin configuración adicional.
\n
• @types/jest — tipos para autocompletado en el IDE.
\n

Instalación en un solo comando:

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

Añade en package.json el script para ejecutar las pruebas:

"scripts": {\n  "test": "jest",\n  "test:watch": "jest --watch"\n}

Ahora todo está listo para el desarrollo guiado por pruebas TypeScript.

Escribimos la primera prueba con TDD: de rojo a verde

Imaginemos que necesitamos escribir una función que verifique si una cadena es un palíndromo. Siguiendo el TDD clásico, comenzamos con la prueba.

Paso 1. Rojo (Red)

Creamos el archivo isPalindrome.test.ts:

import { isPalindrome } from './isPalindrome';\n\ndescribe('isPalindrome', () => {\n  it('debe devolver true para la cadena "racecar"', () => {\n    expect(isPalindrome('racecar')).toBe(true);\n  });\n\n  it('debe devolver false para la cadena "hello"', () => {\n    expect(isPalindrome('hello')).toBe(false);\n  });\n});

Ejecutamos la prueba:

npm test

Vemos un error: Cannot find module './isPalindrome'. Excelente, la fase roja está completa. Ahora necesitamos escribir el código para que la prueba pase.

Paso 2. Verde (Green)

Creamos isPalindrome.ts con la implementación mínima:

export function isPalindrome(str: string): boolean {\n  return str === str.split('').reverse().join('');\n}

Ejecutamos las pruebas de nuevo — ¡verde! Ambas pruebas pasan. Pero esto no es todo.

Paso 3. Refactorización (Refactor)

Nuestra función funciona, pero hay un detalle: no maneja cadenas con espacios y diferentes mayúsculas/minúsculas. Añadimos una nueva prueba:

it('debe ignorar mayúsculas/minúsculas y espacios',