Что такое интеграционное тестирование?

Question

Accepted Answer

**Интеграционное тестирование** проверяет, что несколько **компонентов или модулей работают корректно вместе** — тестирует взаимодействия и точки интеграции (например, код с базой данных, сервисы, вызывающие друг друга, или объединённые модули). Оно выявляет проблемы, которые пропускают модульные тесты (которые изолируют отдельные единицы).

## Что проверяет интеграционное тестирование

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

## Почему интеграционные тесты важны (в сравнении с модульными тестами)

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

## Пример и рекомендации

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

## Почему это важно

Понимание интеграционного тестирования важно, потому что оно **выявляет класс ошибок, которые не могут уловить модульные тесты** — проблемы во взаимодействии компонентов — поэтому это ценное знание для комплексного тестирования.

В то время как модульные тесты проверяют отдельные единицы в изоляции (с использованием mock-объектов), такая изоляция означает, что они **не могут проверить реальную интеграцию**: модуль может пройти все свои тесты, но не работать при фактическом объединении с другими (из-за неправильных предположений о зависимости, неверного запроса к реальной базе данных, несоответствия контракта API или проблем конфигурации). **Интеграционные тесты** заполняют этот пробел, тестируя **компоненты, работающие вместе с реальными (или реалистичными) зависимостями** — проверяя, что код фактически работает с реальной базой данных, что сервисы взаимодействуют корректно и что точки интеграции функционируют — выявляя ошибки связывания, слоя данных и контрактов, которые пропускают изолированные модульные тесты.

Понимание этого дополняющего друг друга взаимодействия (модульные тесты для изолированной логики, интеграционные тесты для реального взаимодействия) является ключом к комплексному тестированию, так как ни один из них в отдельности недостаточен.

Понимание **рекомендаций** — что интеграционные тесты работают медленнее (реальный I/O и подготовка, поэтому они находятся в середине пирамиды с меньшим количеством, чем модульные тесты), используют тестовые базы данных/окружения, сосредоточены на важных точках интеграции (доступ к данным, ключевые взаимодействия сервисов, API) и требуют осторожного управления тестовыми данными/состоянием — отражает практику интеграционного тестирования.

Интеграционные тесты обеспечивают уверенность, что собранные части работают, чего модульные тесты в одиночку дать не могут.

Поскольку реальные приложения состоят из взаимодействующих компонентов, а ошибки интеграции (проблемы с базой данных, несоответствия контрактов, ошибки конфигурации) являются распространёнными и пропускаются модульными тестами, и поскольку интеграционное тестирование выявляет их, проверяя, что компоненты работают вместе, понимание интеграционного тестирования является ценным, практически значимым знанием — существенным дополнением к модульному тестированию, которое выявляет ошибки взаимодействия, важное для комплексного тестирования, проверяющего не только изолированные единицы, но и то, что части системы фактически работают вместе корректно.