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",

Posibles errores con Jest + TypeScript

⚠️ ERROR: Problemas con import / export en jest.config.js

Cuando TypeScript no reconoce la sintaxis import y export en archivos como jest.config.ts, puede deberse a la propiedad "verbatimModuleSyntax" en el archivo tsconfig.json. Esta propiedad activa un modo estricto que prohíbe mezclar sintaxis de módulos CommonJS y ESModule.

✅ Solución

Comenta temporalmente esta línea en tsconfig.json:

// "verbatimModuleSyntax": true

Esto desactiva el modo estricto y permite usar tanto require/module.exports como import/export sin conflicto.

💡 Esta solución es útil durante el desarrollo y pruebas. Una vez que el proyecto se despliegue en producción, puedes volver a activarla si tus módulos están bien definidos.

⚠️ ERROR: TypeScript no reconoce la sintaxis de Jest

Este error aparece cuando el editor subraya funciones como describe, test o expect como si no existieran. Sin embargo, Jest funciona correctamente al ejecutar los tests, ya que este error solo afecta al tipado en tiempo de desarrollo.

✅ Causa

TypeScript no está detectando los tipos globales de Jest, posiblemente porque @types/jest no se está aplicando correctamente.

✅ Solución

1. Crea un archivo llamado jest.setup.ts en la raíz del proyecto.
2. Añade la siguiente línea al inicio:

/// <reference types="jest" />

Esto le indica explícitamente a TypeScript que debe incluir los tipos globales de Jest.

ℹ️ ¿Qué significa /// <reference types="..." />?

Es una directiva especial que le dice al compilador:

“Incluye los tipos globales de esta librería en este archivo.”

No es un comentario común, sino una instrucción que afecta el entorno de tipado.

✅ Actualiza tsconfig.json

Asegúrate de incluir el archivo de setup en la configuración:

"include": ["src", "tests", "jest.setup.ts"],
"exclude": ["node_modules", "dist"]

Si usan aliases, sigan la siguiente configuración:

tsconfig.json

"resolveJsonModule": true,
"esModuleInterop": true

jest.config.ts

import type { Config } from "jest";
import { pathsToModuleNameMapper } from "ts-jest";
import { compilerOptions } from "./tsconfig.json";

const config: Config = {
moduleNameMapper: pathsToModuleNameMapper(compilerOptions.paths, {
    prefix: "<rootDir>/",
  }),
// resto de la configuración de Fernando
}

Esto es porque en mi caso no uso como alias '@src', me gusta crear varios, por ejemplo '@modules' o '@config' dentro del source.

El paso 2. se actualizo a este comando.

npm init jest@latest

Tomado de https://jestjs.io/docs/getting-started#generate-a-basic-configuration-file