Интеграционное тестирование TypeScript с Docker: полное руководство

Введение: зачем нужно интеграционное тестирование TypeScript с Docker?

Интеграционное тестирование — это ключевой этап разработки, который проверяет взаимодействие между различными модулями вашего приложения. В отличие от юнит-тестов, которые изолируют один компонент, интеграционные тесты проверяют, как работают вместе база данных, API, внешние сервисы и бизнес-логика.

Использование Docker в интеграционном тестировании TypeScript решает несколько проблем:

• Изоляция окружения — тесты запускаются в идентичных условиях на всех машинах
• Управление зависимостями — базы данных, очереди и кэши поднимаются автоматически
• Воспроизводимость — тесты дают одинаковые результаты локально и в CI/CD
• Быстрое восстановление — контейнеры пересоздаются за секунды

В этой статье мы разберем практический пример настройки интеграционного тестирования TypeScript-приложения с использованием Docker, Jest и Supertest.

1. Подготовка проекта и установка зависимостей

Начнем с создания базового TypeScript-проекта. Убедитесь, что у вас установлены Node.js (v18+) и Docker.

mkdir typescript-docker-testing
cd typescript-docker-testing
npm init -y
npm install express typescript ts-node @types/node @types/express
npm install --save-dev jest ts-jest @types/jest supertest @types/supertest

Создайте tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "**/*.test.ts"]
}

Настройте Jest в package.json:

"jest": {
  "preset": "ts-jest",
  "testEnvironment": "node",
  "testMatch": ["**/*.test.ts"]
}

2. Создание простого Express-приложения

Создадим структуру папок и простое приложение, которое будет взаимодействовать с базой данных PostgreSQL.

mkdir src
mkdir src/config
mkdir src/models
mkdir src/routes
mkdir src/__tests__

src/config/database.ts — конфигурация подключения к БД:

import { Pool } from 'pg';

const pool = new Pool({
  host: process.env.DB_HOST || 'localhost',
  port: Number(process.env.DB_PORT) || 5432,
  database: process.env.DB_NAME || 'testdb',
  user: process.env.DB_USER || 'testuser',
  password: process.env.DB_PASSWORD || 'testpass'
});

export default pool;

src/app.ts — основное приложение:

import express from 'express';
import userRoutes from './routes/users';

const app = express();
app.use(express.json());
app.use('/api/users', userRoutes);

export default app;

src/index.ts — точка входа:

import app from './app';

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

src/routes/users.ts — простой маршрут для пользователей:

import { Router, Request, Response } from 'express';
import pool from '../config/database';

const router = Router();

router.get('/', async (req: Request, res: Response) => {
  try {
    const result = await pool.query('SELECT * FROM users');
    res.json(result.rows);
  } catch (error) {
    res.status(500).json({ error: 'Database error' });
  }
});

router.post('/', async (req: Request, res: Response) => {
  const { name, email } = req.body;
  try {
    const result = await pool.query(
      'INSERT INTO users (name, email) VALUES ($1, $2) RETURNING *',
      [name, email]
    );
    res.status(201).json(result.rows[0]);
  } catch (error) {
    res.status(500).json({ error: 'Failed to create user' });
  }
});

export default router;

3. Настройка Docker Compose для тестового окружения

Создайте docker-compose.test.yml в корне проекта:

version: '3.8'

services:
  postgres-test:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: testdb
      POSTGRES_USER: testuser
      POSTGRES_PASSWORD: testpass
    ports:
      - "5433:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U testuser -d testdb"]
      interval: 5s
      timeout: 5s
      retries: 5

  app-test:
    build:
      context: .
      dockerfile: Dockerfile.test
    environment:
      DB_HOST: postgres-test
      DB_PORT: 5432
      DB_NAME: testdb
      DB_USER: testuser
      DB_PASSWORD: testpass
      PORT: 3000
    ports:
      - "3001:3000"
    depends_on:
      postgres-test:
        condition: service_healthy

Создайте Dockerfile.test для тестового контейнера:

FROM node:18-alpine

WORKDIR /app

COPY package*.json ./
RUN npm install

COPY . .

CMD ["npm", "test"]

Добавьте скрипт для запуска тестов в package.json:

"scripts": {
  "test": "jest --forceExit --detectOpenHandles",
  "test:integration": "docker-compose -f docker-compose.test.yml up --abort-on-container-exit"
}

4. Написание интеграционных тестов с Jest и Supertest

Теперь создадим файл src/__tests__/users.integration.test.ts:

import request from 'supertest';
import app from '../app';
import pool from '../config/database';

beforeAll(async () => {
  // Создаем таблицу перед тестами
  await pool.query(`
    CREATE TABLE IF NOT EXISTS users (
      id SERIAL PRIMARY KEY,
      name VARCHAR(100) NOT NULL,
      email VARCHAR(100) UNIQUE NOT NULL
    )
  `);
});

afterAll(async () => {
  // Очищаем таблицу и закрываем соединение
  await pool.query('DROP TABLE IF EXISTS users');
  await pool.end();
});

beforeEach(async () => {
  // Очищаем данные между тестами
  await pool.query('DELETE FROM users');
});

describe('Users API Integration Tests', () => {
  test('POST /api/users - should create a new user', async () => {
    const response = await request(app)
      .post('/api/users