Gerador-BR

A Biblioteca Definitiva de Dados Brasileiros para Seus Testes em Node.js.

Instale o pacote NPM gerador-br e pare de se preocupar com massa de dados.
Leve, sem dependências e com uma cobertura completa de dados fictícios para seus testes.

Versão NPM Downloads NPM

Simples de Usar. Poderoso nos Resultados.

// Simplesmente importe e use.
import { cpf, cnpjAlfanumerico, placaMercosul } from 'gerador-br';

// Perfeito para seus testes com Cypress, Playwright, Jest, etc.
it('deve preencher o formulário de cadastro', () => {
  cy.get('#cpf').type(cpf());
  cy.get('#cnpj').type(cnpjAlfanumerico());
  cy.get('#placaVeiculo').type(placaMercosul());
  cy.get('button[type="submit"]').click();
});

Por que Desenvolvedores Amam o Gerador-BR?

Zero Dependências

Adicione ao seu projeto sem se preocupar com pacotes extras. Leve, rápido e seguro, sem poluir seu `node_modules`.

API Modular

Importe apenas as funções que você precisa (ex: `cpf`, `cnpj`), mantendo o bundle final dos seus testes o menor possível.

Dados Válidos

Gera documentos com dígitos verificadores corretos, garantindo que seus dados passem em validações de front-end e back-end.

Open Source

Desenvolvido e mantido pela comunidade. Contribua, reporte bugs ou sugira novas funcionalidades no nosso GitHub.

Cobertura Completa de Dados para Seus Testes

Pessoa Física
  • ✓ CPF, RG, CNH
  • ✓ Título de Eleitor, PIS, CNS
  • ✓ Passaporte e Certidões
  • ✓ Nome, Filiação, Nascimento
  • ✓ Dados Demográficos e mais
Pessoa Jurídica
  • ✓ CNPJ (Numérico e Alfanumérico)
  • ✓ Inscrição Estadual
  • ✓ Razão Social
Financeiro
  • ✓ Cartão de Crédito Válido
  • ✓ Conta Bancária Completa
  • ✓ Agência, Banco e Código
Contatos & Veículos
  • ✓ Endereço Completo com CEP
  • ✓ Placa (Antiga e Mercosul)
  • ✓ Renavam
  • ✓ E-mail, Celular e Telefone

Perguntas Frequentes (FAQ)

Não. O pacote é totalmente independente e não possui nenhuma dependência de produção (`dependencies`). Isso garante que ele seja extremamente leve e seguro para adicionar a qualquer projeto, sem introduzir pacotes de terceiros inesperados.

Todas as funções geradoras são síncronas. Você pode chamá-las diretamente e obter o resultado instantaneamente, sem a necessidade de usar `async/await` ou Promises, o que simplifica muito a escrita dos seus testes.

A documentação completa, com todos os métodos, parâmetros e exemplos de uso, está disponível aqui mesmo no site. Você pode acessá-la diretamente através do link na seção 'Comece a Usar'.

Para documentos como CPF, CNPJ, CNH e outros que possuem dígitos verificadores, o pacote implementa os algoritmos de cálculo oficiais. Isso garante que os dados gerados sejam matematicamente válidos e passem em qualquer validação de sistema.

Pronto para acelerar seus testes automatizados?

Instalar via NPM