Como Gerar CPF Válido para Testes (Guia Rápido Dev)
Se você está testando uma API Restful, construindo formulários no Front-end ou automatizando E2E no Playwright, CPFs no formato de `111.111.111-11` já não são suficientes.
O fluxo de controle de qualidade (QA) de softwares brasileiros mudou nos últimos anos. Os validadores de input, tanto front-end quanto os Middlewares Back-end, analisam a autenticidade dos dados via algoritmos antes mesmo da string chegar ao banco de dados. Isso significa que injetar formulários com "dados sujos e irracionais" para testar um botão de Submit simplesmente resultará sempre no erro de validação (HTTP 400). Pior, se você tentar mascarar testes usando dados vazados ou reais (ferindo a LGPD), seu time está assumindo um grave risco corporativo.
A Matemática dos Dígitos Verificadores
Qualquer biblioteca validadora séria aplicará o cálculo do Módulo 11. O CPF brasileiro não possui 11 números aleatórios. Ele tem apenas 9 números-base. Os 2 últimos dígitos (Dígitos Verificadores) são a resposta de uma equação matemática estrita.
- Você soma os primeiros nove multiplicados por peso decrescente.
- Divide-se o total por 11 para capturar o "Resto" matemático.
- A fórmula espelha a lógica para o segundo dígito também. Se a conta falhar, o validador expulsa o request.
A Solução Rápida: Usando as Ferramentas Gratuitas
A forma mais limpa de alimentar suas fixtures é construir dados sintéticos independentes. Se você não quiser replicar todo esse algoritmo Módulo 11 no seu ambiente nativo de testes com dezenas de Helpers, você pode recorrer à plataforma.
Gerencie seu DB Artificial
Nossa arquitetura possibilita você fatiar e engolir JSONs com extrema rapidez. Ideal para scripts de seeding. É só escolher seu cenário:
Conclusão
Gerar CPFs válidos nunca foi tão necessário quanto na era atual das validações robustas em Edge, TypeScript e middlewares. Dominar o teste de borda de strings no ecossistema brasileiro demanda ferramentas matemáticas refinadas. Respeite as leis digitais, invista na massa de dados correta e melhore a cobertura real do seu QA.