Metodología TDD: pasos para aplicarla, con un ejemplo
La metodología TDD (Test-Driven Development, desarrollo dirigido por tests) es una forma de programar en la que se escribe la prueba antes que el código. Entender la idea es fácil; lo difícil es saber qué hacer el lunes por la mañana delante de un proyecto vacío.
Esta guía te lleva paso a paso con un ejemplo pequeño que puedes copiar y ejecutar: calcular el precio de una entrada de cine. Si buscas qué es TDD y por qué funciona, empieza por qué es TDD (Test-Driven Development).
Piensa en un sastre con su lista de medidas. Apunta una medida que la prenda aún no cumple (el test, en rojo), da la puntada justa para que encaje (el código mínimo, en verde) y ajusta las costuras sin cambiar la talla (el refactor). Después vuelve a la lista a por la siguiente.
Los pasos de la metodología TDD, de un vistazo
- Prepara el entorno para lanzar los tests con una sola orden.
- Parte de un requisito claro y escribe la lista de tests.
- Convierte un caso de la lista en un test y míralo fallar: rojo.
- Escribe el código mínimo para que pase: verde.
- Mejora el código sin cambiar lo que hace: refactor.
- Vuelve a la lista, apunta lo que hayas descubierto y repite hasta vaciarla.
Los pasos 3, 4 y 5 forman el ciclo TDD. En Algoritmo TDD tienes cada uno explicado por separado.
1. Prepara el entorno
Usaremos Node.js 24 y su ejecutor de tests integrado, node:test, así que no hay que instalar nada más. Comprueba tu versión y crea el proyecto:
node --version # v24.x
mkdir cine && cd cine
npm init -y
npm pkg set type=module scripts.test="node --test"
La última línea hace dos cosas en el package.json: permite usar import en lugar de require y hace que npm test lance node --test. Ese comando busca solo los ficheros con nombres como *.test.js y los ejecuta.
2. Parte de un requisito claro y escribe la lista de tests
TDD no empieza con código, sino con un requisito que se entienda y que esté acordado con quien decide qué debe hacer el programa (en Scrum, el product owner). El nuestro:
Una entrada de cine cuesta 9 €. Los menores de 12 años pagan 5 € y las personas de 65 años o más, 6 €. El miércoles es el día del espectador: la entrada cuesta 6 €.
Antes de escribir una línea, apunta los casos que quieres comprobar. Es la lista de tests, como la lista de medidas del sastre: todavía no coses nada, solo apuntas.
- Un adulto paga la entrada general: 9 €.
- Un menor de 12 años paga 5 €.
- Una persona de 65 años o más paga 6 €.
- El miércoles, un adulto paga 6 €.
Kent Beck, que dio forma a TDD, insiste en este paso en su artículo Canon TDD: reconoce que mucha gente se lo salta al leer su libro y avisa de dos errores. Uno, mezclar la lista con decisiones sobre cómo vas a programarlo. Otro, convertir todos los casos en tests de golpe y luego intentar que pasen uno a uno.
¿En qué orden los conviertes en tests? La técnica ZOMBIES propone empezar por el caso cero, seguir con uno y después con muchos, vigilando en cada paso los límites y los errores.
3. Escribe el primer test y míralo fallar (rojo)
Elige un caso de la lista, solo uno, y conviértelo en un test. Los demás puedes dejarlos en el fichero como pendientes con test.todo, para no perderlos de vista. Crea entrada.test.js:
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { precioEntrada } from './entrada.js';
test('un adulto paga la entrada general: 9 €', () => {
assert.equal(precioEntrada({ edad: 30, dia: 'lunes' }), 9);
});
test.todo('un menor de 12 años paga 5 €');
test.todo('una persona de 65 años o más paga 6 €');
test.todo('el miércoles, día del espectador, un adulto paga 6 €');
Fíjate en que el test decide cómo se usa el código antes de que exista: una función precioEntrada que recibe la edad y el día. Por eso se dice que TDD es también una forma de diseñar.
Lánzalo:
npm test
Error [ERR_MODULE_NOT_FOUND]: Cannot find module './entrada.js' imported from ./entrada.test.js
Está en rojo, pero por el motivo equivocado: falla porque el fichero no existe, no porque el precio esté mal. Crea entrada.js con la función vacía:
export function precioEntrada({ edad, dia }) {}
Y vuelve a lanzarlo:
✖ un adulto paga la entrada general: 9 € (1.324414ms)
✔ un menor de 12 años paga 5 € (0.157537ms) # TODO
✔ una persona de 65 años o más paga 6 € (0.089158ms) # TODO
✔ el miércoles, día del espectador, un adulto paga 6 € (0.082916ms) # TODO
ℹ tests 4
ℹ pass 0
ℹ fail 1
ℹ todo 3
✖ un adulto paga la entrada general: 9 € (1.324414ms)
AssertionError [ERR_ASSERTION]: Expected values to be strictly equal:
undefined !== 9
Ahora sí: esperaba 9 y la función devuelve undefined. Ese es el rojo que buscas. Los pendientes salen marcados con # TODO: se cuentan aparte y no hacen fallar la ejecución.
4. Escribe el código mínimo para que pase (verde)
El código mínimo, aunque parezca una trampa:
export function precioEntrada({ edad, dia }) {
return 9;
}
✔ un adulto paga la entrada general: 9 € (0.792608ms)
✔ un menor de 12 años paga 5 € (0.103125ms) # TODO
✔ una persona de 65 años o más paga 6 € (0.09537ms) # TODO
✔ el miércoles, día del espectador, un adulto paga 6 € (0.083859ms) # TODO
ℹ tests 4
ℹ pass 1
ℹ fail 0
ℹ todo 3
Devolver un 9 fijo parece absurdo, pero es honesto: con lo que sabemos hasta ahora, es suficiente. Los siguientes tests obligarán al código a crecer, y lo hará solo hasta donde lo pidan.
El test pide, el código responde. Ni una línea más.
5. Mejora el código sin cambiar lo que hace (refactor)
Con el test en verde, mira el código y pregúntate si se entiende, si hay algo repetido o algún nombre que confunda. Si lo hay, arréglalo y vuelve a lanzar los tests: deben seguir en verde.
Con un return 9 no hay nada que ordenar todavía; ya llegará. Lo importante es no mezclar los pasos: o haces que el test pase, o mejoras el código, pero no las dos cosas a la vez. Beck lo incluye entre los errores típicos en Canon TDD.
6. Vuelve a la lista y repite
Siguiente caso: un menor de 12 años. Quitas su test.todo y escribes el test:
test('un menor de 12 años paga 5 €', () => {
assert.equal(precioEntrada({ edad: 11, dia: 'lunes' }), 5);
});
Rojo (9 !== 5). Para el verde basta con un if (edad < 12) return 5;. Y, al escribirlo, surge una duda: ¿un niño que acaba de cumplir 12 paga 5 o 9? Es justo la frontera donde se cuelan los errores, así que va a la lista.
Así sigue el ciclo con el resto de casos. Este es el recorrido completo, tal y como se ejecutó:
| Test | Rojo | Verde | ¿Algo nuevo para la lista? |
|---|---|---|---|
| Adulto, 9 € | undefined !== 9 |
return 9 |
|
| Menor de 12, 5 € | 9 !== 5 |
if (edad < 12) return 5 |
Con 12 años ya se paga la general |
| Con 12 años, 9 € | Pasa a la primera | Nada que cambiar | |
| 65 años o más, 6 € | 9 !== 6 |
if (edad >= 65) return 6 |
|
| Refactor | Nombres para los números sueltos | ||
| Miércoles, adulto, 6 € | 9 !== 6 |
if (dia === 'miércoles') return 6 |
¿Y un niño el miércoles? |
| Miércoles, niño, 5 € | 6 !== 5 |
Comprobar la edad antes que el día | Lista vacía |
Tres detalles de ese recorrido merecen atención:
- El test de los 12 años pasó a la primera. No es un error: documenta una frontera que ya funcionaba. Un test que pasa sin tocar nada no te hace avanzar en el código, pero deja escrita una decisión del negocio.
- El refactor llegó con el tercer precio. Con tres números sueltos (5, 6, 9) y dos edades, el código empezaba a parecer un jeroglífico, así que se les dio nombre, con todos los tests en verde antes y después.
- La lista sacó una pregunta para el negocio. ¿Un niño paga 5 € o 6 € el miércoles? El código no puede decidirlo. Aquí supusimos que paga el precio más bajo, pero en un proyecto real se pregunta a quien define el requisito.
El resultado final, con sus seis tests en verde:
// entrada.js
const PRECIO_GENERAL = 9;
const PRECIO_INFANTIL = 5;
const PRECIO_SENIOR = 6;
const PRECIO_DIA_ESPECTADOR = 6;
const EDAD_ADULTA = 12;
const EDAD_SENIOR = 65;
export function precioEntrada({ edad, dia }) {
if (edad < EDAD_ADULTA) return PRECIO_INFANTIL;
if (dia === 'miércoles') return PRECIO_DIA_ESPECTADOR;
if (edad >= EDAD_SENIOR) return PRECIO_SENIOR;
return PRECIO_GENERAL;
}
// entrada.test.js
import { test } from 'node:test';
import assert from 'node:assert/strict';
import { precioEntrada } from './entrada.js';
test('un adulto paga la entrada general: 9 €', () => {
assert.equal(precioEntrada({ edad: 30, dia: 'lunes' }), 9);
});
test('un menor de 12 años paga 5 €', () => {
assert.equal(precioEntrada({ edad: 11, dia: 'lunes' }), 5);
});
test('con 12 años ya se paga la entrada general', () => {
assert.equal(precioEntrada({ edad: 12, dia: 'lunes' }), 9);
});
test('una persona de 65 años o más paga 6 €', () => {
assert.equal(precioEntrada({ edad: 65, dia: 'lunes' }), 6);
});
test('el miércoles, día del espectador, un adulto paga 6 €', () => {
assert.equal(precioEntrada({ edad: 30, dia: 'miércoles' }), 6);
});
test('el miércoles, un menor de 12 años sigue pagando 5 €', () => {
assert.equal(precioEntrada({ edad: 8, dia: 'miércoles' }), 5);
});
✔ un adulto paga la entrada general: 9 € (0.755805ms)
✔ un menor de 12 años paga 5 € (0.137854ms)
✔ con 12 años ya se paga la entrada general (0.11012ms)
✔ una persona de 65 años o más paga 6 € (0.108257ms)
✔ el miércoles, día del espectador, un adulto paga 6 € (1.050198ms)
✔ el miércoles, un menor de 12 años sigue pagando 5 € (0.112405ms)
ℹ tests 6
ℹ pass 6
ℹ fail 0
ℹ todo 0
¿Cuándo se para? Cuando la lista está vacía y no se te ocurren más casos. Mañana llegará un requisito nuevo (un descuento para estudiantes, por ejemplo) y el ciclo empezará otra vez con su propia lista.
Errores comunes al aplicar TDD
En Canon TDD, Beck enumera los errores que más ve. Estos son los que más afectan a quien empieza:
| Error | Qué hacer en su lugar |
|---|---|
| Escribir todos los tests de golpe y luego el código | Un test cada vez; el resto, en la lista |
| Copiar en el test el valor que devuelve el código | Calcular el valor esperado a partir del requisito, no de la ejecución |
| Refactorizar mientras intentas pasar a verde | Primero que funcione; después, que esté bien |
| Escribir tests sin comprobaciones solo para subir la cobertura | Cada test comprueba un comportamiento concreto |
| Abstraer demasiado pronto | Esperar a ver la repetición antes de generalizar |
Si trabajas con un agente de IA
Un agente de IA puede escribir tests y código muy deprisa, y eso hace que estos pasos importen más, no menos. La lista concreta es criterio nuestro, dentro de IA Limpia; la guía de buenas prácticas de Claude Code también recomienda pedir primero un test que falle (code.claude.com/docs/en/best-practices, consultada el 8-11-2026).
- La lista la decides tú. Puedes pedirle ideas al agente, pero eres tú quien valida qué casos cuenta el requisito.
- Un test cada vez. Pídele que escriba solo el siguiente test de la lista y que lo ejecute antes de tocar el código, para que veas el rojo.
- Revisa los valores esperados. Comprueba que salen del requisito y no del resultado que dio el código.
- Vigila los tests. Si un test desaparece, se desactiva o se marca como pendiente sin que lo hayas pedido, para y revisa.
- El refactor también se revisa. Que los tests sigan en verde es necesario, pero no basta: el código tiene que entenderse.
El punto 4 coincide con lo que cuenta Beck en Augmented Coding: Beyond the Vibes (junio de 2025): una de sus señales de que el agente se estaba desviando era que hiciera trampas, por ejemplo desactivando o borrando tests.
Tu siguiente paso
Copia el ejemplo, ejecútalo y añade un caso nuevo a la lista: un descuento del 20 % para estudiantes, salvo el miércoles. Hazlo pasar por rojo, verde y refactor antes de mirar cómo lo resolverías de memoria.
Si programas en Ruby, el mismo ciclo con Minitest está en testing en Ruby. Y cuando los pasos te salgan solos, pruébalos con un problema más grande: la kata del Juego de la Vida con TDD enseña a empezar por la pieza más pequeña.
Fuentes
Comprobado el 7 de noviembre de 2026.
- Kent Beck, Canon TDD (11 de diciembre de 2023): los cinco pasos con la lista de tests y la lista de errores comunes.
- Kent Beck, Augmented Coding: Beyond the Vibes (25 de junio de 2025): señales de alarma al trabajar con un agente.
- Documentación de Node.js 24, Test runner:
node --test, patrones de ficheros que busca,todoy reporterspecpor defecto. - El ejemplo se ha ejecutado con Node.js 24.21.0 y npm 11.19.0 en Linux. Las salidas son reales; se han omitido las líneas de resumen sin interés (
suites,cancelled,skipped,duration_ms) y la traza de pila de los errores.