Note + TypeScript + Jest = Testing

pasos-node-ts-jest.md

Pasos para configurar Jest con TypeScript, en Node

Documentación oficial sobre Jest

1. Instalaciones de desarrollo (super test es útil para probar Express)

npm install -D jest @types/jest ts-jest supertest

2. Crear archivo de configuración de Jest

npx jest --init

3. En el archivo jest.config.js configurar

preset: 'ts-jest',
testEnvironment: "jest-environment-node",

// Opcional - The paths to modules that run some code to configure or set up the testing environment before each test
// setupFiles: ['dotenv/config'],

4. Crear scripts en el package.json

"test": "jest",
"test:watch": "jest --watch",
"test:coverage": "jest --coverage",

Escribo todo esto usando Node 24.12 LTS y un dolooooor de cabeza que en absoluto se lo achaco a Fernando, ya que él durante el curso usaba versiones de dependencias de hace, alrededor, de dos años. Todo eso ha traído una barbaridad de cambios por el camino y los errores y los warnings comienzan a aparecer por todas partes.

Quiero dar gracias a los comentarios anteriores, porque me han ayudado a arreglar algunos de los errores (actualmente me encuentro visualizando el video de los test con Jest en 03-Callbacks dentro de la carpeta 02-bases).

Copio y pego mis dependencias y mis configuraciones por si a alguien le son de utilidad. Ojo especial atención a la parte de "Environment Settings" porque de ahí vienen los problemas del uso de módulos experimentales. Comenté Types y descomenté Lib y Types (un segundo types que aparece después) por recomendación del propio Typescript para Node.

Importante también el "verbatimModuleSyntax": false.

A principios de 2026, el tsconfig.json que nos enseña Fernando y el que vemos nosotros es visualmente diferente.

tsconfig.json:

{

"include": ["src", "tests", "jest.setup.ts"],
"exclude": ["node_modules", "dist"],
// Visit https://aka.ms/tsconfig to read more about this file
"compilerOptions": {
// File Layout
"rootDir": "./",
"outDir": "dist",

// Environment Settings
// See also https://aka.ms/tsconfig/module
"module": "nodenext",
"target": "esnext",
// "types": [],
// For nodejs:
"lib": ["esnext"],
"types": ["node"],
// and npm install -D @types/node

// Other Outputs
"sourceMap": true,
"declaration": true,
"declarationMap": true,

// Stricter Typechecking Options
"noUncheckedIndexedAccess": true,
"exactOptionalPropertyTypes": true,

// Style Options
// "noImplicitReturns": true,
// "noImplicitOverride": true,
// "noUnusedLocals": true,
// "noUnusedParameters": true,
// "noFallthroughCasesInSwitch": true,
// "noPropertyAccessFromIndexSignature": true,

// Recommended Options
"strict": true,
"jsx": "react-jsx",
"verbatimModuleSyntax": false,
"isolatedModules": true,
"noUncheckedSideEffectImports": true,
"moduleDetection": "force",
"skipLibCheck": true,

}
}

Mi Package.json

{
"name": "02-bases",
"version": "0.0.1",
"description": "Esta es mi primera aplicación real de Node",
"license": "MIT",
"author": "Francisco Rodríguez",
"type": "commonjs",
"main": "app.js",
"scripts": {
"dev": "nodemon",
"build": "rimraf ./dist && tsc",
"start": "npm run build && node dist/app.js",
"test": "jest",
"test:watch": "jest --watch",
"test:coverage": "jest --coverage"
},
"devDependencies": {
"@types/jest": "^30.0.0",
"@types/node": "^25.0.3",
"jest": "^30.2.0",
"nodemon": "^3.1.11",
"rimraf": "^6.1.2",
"supertest": "^7.2.2",
"ts-jest": "^29.4.6",
"ts-node": "^10.9.2",
"typescript": "^5.9.3"
},
"dependencies": {
"axios": "^1.13.2",
"get-age": "^1.0.1",
"uuid": "^13.0.0",
"winston": "^3.19.0"
}
}

Si el app.test.ts te muestra errores en describe, test y expect ....

En el tsconfig.json, se corrige colocando esta linea:

"types": ["node", "jest"],

Usualmente los valores por defecto son: "types": ["node"],

Si tienen algún feedback, lo dejan por acá ....

Gracias Fernando, por tan valioso material.