TDD na prática: construindo uma API REST com Node.js e testes automatizados

#Jest
#Node.js
#Mongoose
#Express
#MongoDB

Esse projeto foi uma adaptação de uma aula da DIO (Digital Innovation One), onde a proposta era construir uma API utilizando Python, FastAPI, Pydantic, Pytest e MongoDB — tudo com foco em aplicar o TDD (Test-Driven Development) na prática.

Decidi então recriar o projeto em Node.js, utilizando Express, Jest e Supertest, mantendo o mesmo objetivo de estruturar uma API com testes desde o início.

🚀 Repositório no GitHub: github.com/CarolinaCamposs/TDD-Store-API-JS

🧠 O que é TDD?

TDD (Desenvolvimento Orientado por Testes) é uma abordagem onde primeiro escrevemos testes automatizados — que falham — para depois implementar o código necessário para fazê-los passar. O ciclo se baseia em três etapas:

Red: Escreva um teste que falhe.
Green: Implemente o mínimo para passar no teste.
Refactor: Refatore o código com confiança, já que os testes garantem que tudo continua funcionando.

🏗️ A estrutura do projeto

Node.js + Express para criar a API REST
Jest para os testes
Supertest para simular requisições HTTP
MongoDB com Mongoose para persistência dos dados

✍️ Escrevendo o primeiro teste

Antes mesmo de criar a rota, escrevi o seguinte teste para criar um produto:

describe('Product Routes', () => {
it('should create a new product', async () => {
  const response = await request(app)
    .post('/products')
    .send({ name: 'Produto Teste 2', price: 29.99 });


  expect(response.status).toBe(201);
  expect(response.body).toHaveProperty('_id');
});

🔴 Como esperado, o teste falhou com erro 404, porque a rota ainda não existia.

🛠️ Implementando a rota

Com base no teste, implementei a rota e o controller responsável por criar um novo produto. Depois disso, rodei novamente os testes e...

async function createProduct(req, res) {
try {
  const { name, price } = req.body;
  const product = await Product.create({ name, price });
  return res.status(201).json(product);
} catch (error) {
  return res.status(500).json({ error: 'Erro ao criar produto' });
}
}

✅ Tudo passou!

Esse é o coração do TDD: garantir que cada funcionalidade já nasce testada e validada.