Mockear Prisma con Jest en NestJS

Mockear Prisma con Jest en NestJS En pruebas unitarias con NestJS es habitual necesitar un doble de prueba del cliente de base de datos. PrismaService encapsula Prisma Client y, si no lo aislamos, las pruebas se vuelven lentas, frágiles o dependen de infraestructura externa. A continuación te muestro un patrón claro para crear un mock tipado de Prisma y enlazarlo en el módulo de testing de NestJS.

Concepto 1. Define un tipo para el objeto mock que refleje solo lo que vas a usar 2. Asigna el valor del mock en el provider con useValue dentro del TestingModule

Escenario base Tienes un servicio NestJS, por ejemplo TheServiceYouWantToTest, cuyo constructor inyecta PrismaService. Este PrismaService expone los modelos de Prisma Client, por ejemplo model.findMany, model.findUnique, etc. Para testear TheServiceYouWantToTest sin tocar la base de datos, necesitas un PrismaService falso pero tipado.

Patrón de mockeo recomendado 1. Crea un tipo TypeScript llamado MockPrismaService que contenga exactamente los modelos y métodos que tu servicio usa. Ejemplo mental: un objeto con la propiedad model y dentro métodos como findMany de tipo jest.Mock. 2. En el beforeEach, construye un objeto mockPrismaService que cumpla ese tipo y define cada método como jest.fn(). 3. Crea el módulo de pruebas con Test.createTestingModule e incluye tu servicio real en providers junto a un provider que haga provide PrismaService y useValue mockPrismaService. 4. Obtén el mock ya inyectado llamando a module.get de PrismaService. De esta forma el objeto resultante tiene el tipo MockPrismaService y está vinculado al inyector de Nest. 5. En cada prueba, prepara el comportamiento con métodos como prisma.model.findMany.mockResolvedValue y verifica con expect(prisma.model.findMany).toHaveBeenCalled. 6. Resetea el estado entre pruebas con jest.clearAllMocks para evitar interferencias.

Buenas prácticas de tipado - Define solo los métodos de Prisma que realmente uses en la implementación, no todo el cliente. Esto hace tus pruebas más legibles y reduce ruido. - Si tu servicio usa transacciones, añade una propiedad $transaction en el mock como jest.fn. - Para escenarios con múltiples modelos, añade propiedades por modelo, por ejemplo user, post, order, cada una con los métodos relevantes. - Si prefieres utilidades de Jest, considera jest.Mocked para generar tipos de mocks a partir de interfaces, o usa Partial cuando prototipas rápidamente, y luego endurece el tipo para evitar falsos positivos.

Errores comunes y cómo evitarlos - Type errors al acceder a prisma.model.findMany: confirma que el tipo MockPrismaService declare ese método como jest.Mock. - El mock no se comparte con el servicio bajo prueba: asegúrate de usar provide PrismaService con useValue y recuperar el mismo objeto mediante module.get, no crees instancias separadas. - No olvidar await en los métodos async: usa mockResolvedValue para promesas y mockRejectedValue para simular errores.

Resumen operativo rápido - Define MockPrismaService con los métodos necesarios como jest.Mock. - Construye mockPrismaService con jest.fn en cada método. - Inyecta con provide PrismaService y useValue mockPrismaService en el TestingModule. - Recupera el mock con module.get y úsalo para preparar respuestas y verificar llamadas.

En Q2BSTUDIO diseñamos y probamos soluciones de software a medida y aplicaciones a medida con estándares de calidad, cubriendo desde el backend con NestJS hasta pipelines de CI, automatización de pruebas y despliegue. Si buscas un partner que domine testing, arquitectura limpia y delivery continuo, descubre cómo impulsamos tu proyecto de software a medida.

Además de ingeniería backend sólida, nuestro equipo integra inteligencia artificial, agentes IA e IA para empresas para acelerar el desarrollo, y reforzamos la ciberseguridad con auditorías y buenas prácticas desde el código. Operamos en servicios cloud AWS y Azure, orquestamos datos con servicios inteligencia de negocio y potenciamos reporting con Power BI para crear productos más fiables y escalables.

Si quieres llevar tus pruebas unitarias y de integración al siguiente nivel, incorporar dobles de prueba efectivos como el mock de Prisma con Jest, y conectar todo con automatización de procesos en tus pipelines, contáctanos. Podemos ayudarte a definir una estrategia integral que combine desarrollo de aplicaciones a medida, prácticas de ciberseguridad, gobierno de datos y despliegue en la nube. Y si necesitas una capa de IA pragmática en tu stack, conoce nuestros servicios de inteligencia artificial.

Palabras clave para nuestros servicios: aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA, power bi.