Curso práctico de TypeScript. Cada tema combina una lección breve (el concepto) con un ejercicio que se valida con tests: primero se entiende, después se escribe.
- Node.js 20 o superior. El proyecto fija la versión 24.15.0 en
.nvmrc. - Un gestor de versiones de Node (nvm, fnm, asdf, etc.) que lea
.nvmrctomará esa versión automáticamente. No es obligatorio: alcanza con tener Node instalado en una versión compatible.
npm installSi se usa un gestor de versiones, conviene alinear la versión con el .nvmrc
del proyecto antes de instalar.
Cada carpeta NN-tema/ tiene tres archivos:
README.md— la teoría y los ejemplos. Se lee primero.ejercicio.ts— el código a completar. CadaTODOindica qué falta.ejercicio.test.ts— los tests. No se tocan; son la meta a alcanzar.
El flujo:
- Leer el
README.mddel tema. - Completar los
TODOdelejercicio.ts. El editor marca los errores de tipo al instante, sobre la línea correspondiente: esa es la guía principal mientras se escribe. - Correr
npm testpara confirmar que los tipos y el comportamiento del tema quedan en verde.
Los temas se completan en orden. Como
npm testrevisa todo el curso, aparecen en rojo los temas que todavía no se completaron: es lo esperado.
npm test # todo el curso en watch: tipos (--typecheck) + comportamiento
npm run test:run # lo mismo, una sola vez
npm run check # solo revisa tipos con tsc, sin ejecutar testsnpm test valida dos cosas a la vez: que los tipos sean correctos
(--typecheck) y que el comportamiento en tiempo de ejecución sea el
esperado. El chequeo de tipos abarca todo el proyecto; por eso, mientras se
trabaja un tema, el editor es la mejor guía: muestra el error de tipo justo en
la línea del archivo abierto.
Los temas están en las carpetas numeradas (00-..., 01-...), en orden. Se
recomienda seguirlas de forma secuencial.