¿Qué es una prueba de integración?

Question

Accepted Answer

**Las pruebas de integración** verifican que **múltiples componentes o unidades funcionen correctamente juntos** — probando las interacciones y puntos de integración (como código con una base de datos, servicios llamándose entre sí, o módulos combinados). Detectan problemas que las pruebas unitarias (que aíslan unidades) no pueden detectar.

## Qué verifican las pruebas de integración

```text
Integration tests verify COMPONENTS WORKING TOGETHER (not in isolation):
  → code + DATABASE (does the data layer actually work with a real DB?)
  → service A calling service B / an external API
  → multiple modules/units combined; the integration POINTS between them
→ catches issues in how parts INTERACT — which unit tests (isolated) can't catch.
```

## Por qué las pruebas de integración son importantes (frente a pruebas unitarias)

```text
UNIT tests isolate units (mocking dependencies) → fast, but DON'T verify real integration:
  → a unit can pass its tests but FAIL when combined (wrong assumptions about a dependency,
    a real DB query that's wrong, an API contract mismatch, config issues)
INTEGRATION tests use REAL (or realistic) dependencies → catch these interaction bugs:
  → wiring/configuration errors, data layer issues, contract mismatches between components
→ Integration tests verify the parts actually work TOGETHER.
```

## Ejemplo y consideraciones

```js
// integration test: the repository actually works with a (test) database
test('UserRepository saves and retrieves a user', async () => {
  const repo = new UserRepository(testDb);     // REAL test database
  await repo.save({ name: 'Ann' });
  const user = await repo.findByName('Ann');    // real query
  expect(user.name).toBe('Ann');
});
```

```text
→ SLOWER than unit tests (real I/O, setup); use a TEST database/environment
→ Test important integration points (data access, key service interactions, APIs)
→ Fewer than unit tests (the pyramid middle); manage test data/state carefully
```

## Por qué es importante

Entender las pruebas de integración es importante porque **detectan una clase de errores que las pruebas unitarias no pueden** — problemas en cómo los componentes funcionan juntos — por lo que es un conocimiento valioso para pruebas exhaustivas.

Mientras que las pruebas unitarias verifican unidades individuales en aislamiento (burlándose de dependencias), este aislamiento significa que **no pueden verificar una integración real**: una unidad puede pasar todas sus pruebas pero fallar cuando se combina realmente con otras (por suposiciones incorrectas sobre una dependencia, una consulta de base de datos real incorrecta, una falta de coincidencia en el contrato de una API, o problemas de configuración). **Las pruebas de integración** cierran esta brecha probando **componentes trabajando juntos con dependencias reales (o realistas)** — verificando que el código realmente funciona con una base de datos real, que los servicios interactúan correctamente, y que los puntos de integración funcionan — detectando los errores de cableado, capa de datos y contratos que las pruebas unitarias aisladas no detectan.

Entender esta relación complementaria (pruebas unitarias para lógica aislada, pruebas de integración para interacciones reales) es clave para pruebas exhaustivas, ya que ninguna de las dos por sí sola es suficiente.

Entender las **consideraciones** — que las pruebas de integración son más lentas (E/S real y configuración, por lo que se sitúan en el medio de la pirámide con menos que las pruebas unitarias), usan bases de datos/entornos de prueba, se enfocan en puntos de integración importantes (acceso a datos, interacciones clave de servicios, APIs), y requieren una gestión cuidadosa de datos/estado de prueba — refleja la práctica de las pruebas de integración.

Las pruebas de integración proporcionan confianza en que las partes ensambladas funcionan, lo que las pruebas unitarias por sí solas no pueden dar.

Ya que las aplicaciones reales se componen de componentes que interactúan y los errores de integración (problemas de base de datos, desajustes de contratos, errores de configuración) son comunes y los pierden las pruebas unitarias, y ya que las pruebas de integración los detectan verificando que los componentes funcionen juntos, entender las pruebas de integración es un conocimiento valioso y prácticamente relevante — un complemento esencial para las pruebas unitarias que detecta errores de interacción, importante para pruebas exhaustivas que verifica no solo unidades aisladas sino que las partes del sistema realmente funcionan juntas correctamente.