Paralelização segura de testes
Corte o tempo da suíte rodando em paralelo, sem os testes pisarem uns nos outros.
Avançado
- ci
- performance
- isolation
Problema
A suíte está correta, mas lenta, então o retorno demora. Ligar o paralelismo sem cuidado faz os testes falharem de forma intermitente, brigando por dados e portas compartilhados.
Solução
O paralelismo só é seguro quando os testes são isolados. Dê a cada worker o seu próprio espaço de dados (schema, prefixo ou contêiner) e nunca dependa da ordem de execução. Depois ligue o modo paralelo do runner e divida a suíte entre as máquinas do CI.
Torne os recursos compartilhados por worker: um schema de banco único ou uma porta aleatória derivada do índice do worker elimina a disputa.
Trechos de código
// Vitest/Jest expõem um id único por worker.
const workerId = process.env.VITEST_WORKER_ID ?? '1';
const schema = `test_${workerId}`;
beforeAll(async () => {
await db.createSchema(schema);
});
afterAll(async () => {
await db.dropSchema(schema);
});# Playwright: divide a suíte entre 4 runners
npx playwright test --shard=1/4Armadilhas
- Estado global compartilhado (um único banco de teste, portas fixas): a causa clássica da instabilidade em paralelo.
- Testes que dependem de ordem e só passam quando rodam em sequência.
- Dividir demais suítes pequenas: o custo de subir os workers pode superar a economia.