Czym jest testowanie integracyjne?

Question

Accepted Answer

**Testowanie integracyjne** weryfikuje, że wiele **komponentów lub jednostek działa prawidłowo razem** — testując interakcje i punkty integracji (takie jak kod z bazą danych, usługi wzywające się nawzajem, lub połączone moduły). Ujawnia problemy, które testy jednostkowe (które izolują jednostki) pomijają.

## Co weryfikuje testowanie integracyjne

```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.
```

## Dlaczego to ważne

```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.
```

## Przykład i zagadnienia

```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
```

## Dlaczego to ważne

Zrozumienie testowania integracyjnego jest ważne, ponieważ **ujawnia klasę błędów, których testy jednostkowe nie mogą wychwycić** — problemy w sposobie współpracy komponentów — więc jest cenną wiedzą dla kompleksowego testowania.

Pod czas gdy testy jednostkowe weryfikują poszczególne jednostki w izolacji (mockując zależności), ta izolacja oznacza, że **nie mogą weryfikować rzeczywistej integracji**: jednostka może przejść wszystkie swoje testy, ale nie działać po połączeniu z innymi (ze względu na błędne założenia dotyczące zależności, nieprawidłowe rzeczywiste zapytania do bazy danych, niezgodność umowy API, lub problemy z konfiguracją). **Testy integracyjne** wypełniają tę lukę poprzez testowanie **komponentów działających razem z rzeczywistymi (lub realistycznymi) zależnościami** — weryfikując, że kod faktycznie działa z rzeczywistą bazą danych, że usługi oddziałują poprawnie, oraz że punkty integracji funkcjonują — ujawniając błędy okablowania, warstwy danych, i umowy, które izolowane testy jednostkowe pomijają.

Zrozumienie tej komplementarnej relacji (testy jednostkowe dla izolowanej logiki, testy integracyjne dla rzeczywistych interakcji) jest kluczowe dla kompleksowego testowania, ponieważ żaden z nich samodzielnie nie jest wystarczający.

Zrozumienie **zagadnień** — że testy integracyjne są wolniejsze (rzeczywiste I/O i setup, więc znajdują się pośrodku piramidy z mniejszą liczbą niż testy jednostkowe), używają testowych baz danych/środowisk, skupiają się na ważnych punktach integracji (dostęp do danych, kluczowe interakcje usług, API), i wymagają starannego zarządzania danymi testowymi/stanem — odzwierciedla praktyczne testowanie integracyjne.

Testy integracyjne zapewniają pewność, że połączone części działają, czego same testy jednostkowe nie mogą zagwarantować.

Ponieważ rzeczywiste aplikacje składają się z oddziałujących komponentów i błędy integracyjne (problemy z bazą danych, niezgodności umów, błędy konfiguracji) są powszechne i pomijane przez testy jednostkowe, a ponieważ testowanie integracyjne je ujawnia poprzez weryfikację współpracy komponentów, zrozumienie testowania integracyjnego jest cenną, praktycznie istotną wiedzą — niezbędnym uzupełnieniem testowania jednostkowego, które ujawnia błędy interakcji, ważne dla kompleksowego testowania, które weryfikuje nie tylko izolowane jednostki, ale że części systemu faktycznie działają razem prawidłowo.