Testes de Integração TypeScript com Docker: Guia Completo

Introdução: por que você precisa de testes de integração TypeScript com Docker?

Testes de integração são uma etapa chave no desenvolvimento que verifica a interação entre diferentes módulos da sua aplicação. Ao contrário dos testes unitários, que isolam um único componente, os testes de integração verificam como o banco de dados, API, serviços externos e lógica de negócios funcionam juntos.

O uso de Docker em testes de integração TypeScript resolve vários problemas:

• Isolamento de ambiente — os testes são executados em condições idênticas em todas as máquinas
• Gerenciamento de dependências — bancos de dados, filas e caches são iniciados automaticamente
• Reprodutibilidade — os testes produzem os mesmos resultados localmente e em CI/CD
• Recuperação rápida — os contêineres são recriados em segundos

Neste artigo, vamos analisar um exemplo prático de configuração de testes de integração para uma aplicação TypeScript usando Docker, Jest e Supertest.

1. Preparação do projeto e instalação de dependências

Vamos começar criando um projeto TypeScript básico. Certifique-se de ter Node.js (v18+) e Docker instalados.

mkdir typescript-docker-testingcd typescript-docker-testingnpm init -ynpm install express typescript ts-node @types/node @types/expressnpm install --save-dev jest ts-jest @types/jest supertest @types/supertest

Crie o tsconfig.json:

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

Configure o Jest no package.json:

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

2. Criando uma aplicação Express simples

Vamos criar a estrutura de pastas e uma aplicação simples que interagirá com o banco de dados PostgreSQL.

mkdir srcmkdir src/configmkdir src/modelsmkdir src/routesmkdir src/__tests__

src/config/database.ts — configuração de conexão com o banco de dados:

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 — aplicação principal:

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 — ponto de entrada:

import app from './app';

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

src/routes/users.ts — rota simples para usuários:

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