Documentación Gerador-BR

La biblioteca definitiva de datos brasileños para sus pruebas en Node.js

Instale el paquete NPM gerador-br y deje de preocuparse por los datos de prueba. Ligero, sin dependencias y con cobertura completa de datos ficticios para sus pruebas.

NPM VersionNPM Downloads

Empezando

Sobre Gerador-BR

Generador de Datos Ficticios - Brasil

Genere datos ficticios/válidos, para pruebas y desarrollo de Software.

Ideal para pruebas automatizadas con Cypress, Playwright, Jest, Node.js Test Runner, Jasmine, Mocha, Chai, Supertest, Sinon y Puppeteer.

Instalación

Shell
npm install gerador-br

O

Shell
yarn add gerador-br

Importación

ES Module:

JS
import { gerar } from 'gerador-br';

CommonJS:

JS
const { gerar } = require('gerador-br');

Uso

Importe solo la(s) función(es) que necesite:

JS
1
2
3
4
5
6
7
import { nome, cpf, cnpj, placaMercosul } from 'gerador-br'; // ES Module
// const { nome, cpf, cnpj, placaMercosul } = require('gerador-br'); // CommonJS
console.log(nome.femininoCompleto());
console.log(cpf());
console.log(cnpj());
console.log(placaMercosul());

O importe todo el módulo 'gerar' y use cualquier función que desee:

JS
1
2
3
4
5
6
7
8
import { gerar } from 'gerador-br'; // ES Module
// const { gerar } = require('gerador-br'); // CommonJS
console.log(gerar.nome.femininoCompleto());
console.log(gerar.cpf());
console.log(gerar.cnpj());
console.log(gerar.contaBancaria());
console.log(gerar.cartaoCredito());

Documentos PF

Ejemplos de uso para generar documentos de Persona Física.

CPF

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { cpf } from 'gerador-br'; // ES Module
// const { cpf } = require('gerador-br'); // CommonJS
// Gera CPF sem máscara e de estado aleatório
console.log(cpf());
// Gera CPF com máscara e de estado aleatório
console.log(cpf(true));
// Gera CPF com máscara e do estado informado
console.log(cpf(true, "RS"));
// Gera CPF sem máscara e do estado informado
console.log(cpf(false, "MG"));

CNH

JS
1
2
3
4
5
6
7
8
import { cnh, cnhCategoria } from 'gerador-br'; // ES Module
// const { cnh, cnhCategoria } = require('gerador-br'); // CommonJS
// Gera CNH aleatória
console.log(cnh());
// Gera Categoria CNH
console.log(cnhCategoria());

RG

JS
1
2
3
4
5
6
7
8
import { rg } from 'gerador-br'; // ES Module
// const { rg } = require('gerador-br'); // CommonJS
// Gera RG sem máscara
console.log(rg());
// Gera RG com máscara
console.log(rg(true));

CNS

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import { cns } from 'gerador-br'; // ES Module
// const { cns } = require('gerador-br'); // CommonJS
// Gera CNS (Cartão Nacional Saúde) sem máscara e tipo aleatório
console.log(cns());
// Gera CNS sem máscara e do tipo informado
console.log(cns(false, 'beneficiario'));
console.log(cns(false, 'profissional'));
// Gera CNS com máscara e tipo aleatório
console.log(cns(true));
// Gera CNS com máscara e do tipo informado
console.log(cns(true, 'beneficiario'));
console.log(cns(true, 'profissional'));

PIS

JS
1
2
3
4
5
6
7
8
import { pis } from 'gerador-br'; // ES Module
// const { pis } = require('gerador-br'); // CommonJS
// Gera PIS sem máscara
console.log(pis());
// Gera PIS com máscara
console.log(pis(true));

Título Electoral

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { tituloEleitor } from 'gerador-br'; // ES Module
// const { tituloEleitor } = require('gerador-br'); // CommonJS
// Gera Título de Eleitor sem máscara e de estado aleatório
console.log(tituloEleitor());
// Gera Título de Eleitor com máscara e de estado aleatório
console.log(tituloEleitor(true));
// Gera Título de Eleitor sem máscara e de estado informado
console.log(tituloEleitor(true, 'SE'));
// Gera Título de Eleitor com máscara e de estado informado
console.log(tituloEleitor(false, 'PR'));

Pasaporte

JS
1
2
3
4
5
import { passaporte } from 'gerador-br'; // ES Module
// const { passaporte } = require('gerador-br'); // CommonJS
// Gera Passaporte aleatório
console.log(passaporte());

Certificado

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import { certidao } from 'gerador-br'; // ES Module
// const { certidao } = require('gerador-br'); // CommonJS
// Certidão aleatória
console.log(certidao.aleatoria()); // com máscara
console.log(certidao.aleatoria(false)); // sem máscara
// Certidão de nascimento
console.log(certidao.nascimento()); // com máscara
console.log(certidao.nascimento(false)); // sem máscara
// Certidão de casamento
console.log(certidao.casamento()); // com máscara
console.log(certidao.casamento(false)); // sem máscara
// Certidão de óbito
console.log(certidao.obito()); // com máscara
console.log(certidao.obito(false)); // sem máscara
// Objeto com os detalhes de Certidão
console.log(certidao.aleatoriaObj()); // Objeto detalhado de certidão aleatória
console.log(certidao.nascimentoObj()); // Objeto detalhado de certidão de nascimento
console.log(certidao.casamentoObj()); // Objeto detalhado de certidão de casamento
console.log(certidao.obitoObj()); // Objeto detalhado de certidão de óbito

Documentos PJ

Ejemplos de uso para generar documentos de Persona Jurídica.

CNPJ

JS
1
2
3
4
5
6
7
8
import { cnpj } from 'gerador-br'; // ES Module
// const { cnpj } = require('gerador-br'); // CommonJS
// Gera CNPJ sem máscara
console.log(cnpj());
// Gera CNPJ com máscara
console.log(cnpj(true));

CNPJ Alfanumérico

JS
1
2
3
4
5
6
7
8
import { cnpjAlfanumerico } from 'gerador-br'; // ES Module
// const { cnpjAlfanumerico } = require('gerador-br'); // CommonJS
// Gera CNPJ Alfanumérico com máscara
console.log(cnpjAlfanumerico(true));
// Gera CNPJ Alfanumérico sem máscara
console.log(cnpjAlfanumerico(false));

Inscripción Estatal

JS
1
2
3
4
5
6
7
8
9
10
import { inscricaoEstadual } from 'gerador-br'; // ES Module
// const { inscricaoEstadual } = require('gerador-br'); // CommonJS
// Gera Inscrição Estadual aleatória e do estado informado
console.log(inscricaoEstadual()); // Sem informar o estado
console.log(inscricaoEstadual('AC')); // AC 01.335116638
console.log(inscricaoEstadual('AP')); // AP 03.42773842
console.log(inscricaoEstadual('BA')); // BA 16408652-16
console.log(inscricaoEstadual('DF')); // DF 0724.4814180
console.log(inscricaoEstadual('RJ')); // RJ 41038311.44

Nombre Empresa

JS
1
2
3
4
5
6
import { nomeEmpresa } from 'gerador-br'; // ES Module
// const { nomeEmpresa } = require('gerador-br'); // CommonJS
// Gera Nome de Empresa baseado em filmes, séries, livros, videogames, animação, hq, etc
console.log(nomeEmpresa()); // Exemplo: "Wayne Enterprises", "Los Pollos Hermanos", "Nakatomi Corporation"
console.log(nomeEmpresa('BR')); // Exemplo: "Indústrias Tabajara", "Vavá Tur"

Bancos

Ejemplos de uso para generar datos bancarios.

Banco

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import { banco } from 'gerador-br'; // ES Module
// const { banco } = require('gerador-br'); // CommonJS
// Gera dados de um banco aleatório
console.log(banco());
// Opcionalmente, atribua o objeto a uma variável e utilize as propriedades
const bnc = banco();
console.log(bnc.codigoBanco);
console.log(bnc.nomeBanco);
console.log(bnc.razaoSocial);
console.log(bnc.ispb);
// Gera dados do banco informado
console.log(banco(237));

Lista de Códigos de Bancos

JS
1
2
3
4
5
import { listaCodigosBancos } from 'gerador-br'; // ES Module
// const { listaCodigosBancos } = require('gerador-br'); // CommonJS
// Retorna uma lista de códigos de bancos
console.log(listaCodigosBancos());

Tarjeta de Crédito

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
import { cartaoCredito, nome } from 'gerador-br'; // ES Module
// const { cartaoCredito, nome } = require('gerador-br'); // CommonJS
// Gera objeto cartaoCredito com as propriedades:
// numero (sem máscara), bandeira, cvv, dataExpiracao e nomeTitular aleatório (abreviado)
console.log(cartaoCredito());
// Opcionalmente, atribua o objeto a uma variável e utilize as propriedades
const cc = cartaoCredito();
console.log(cc.numero);
console.log(cc.bandeira);
console.log(cc.cvv);
console.log(cc.dataExpiracao);
console.log(cc.nomeTitular);
// Gera objeto cartaoCredito com as propriedades:
// numero (com máscara), bandeira, cvv, dataExpiracao e nomeTitular informado (abreviado)
console.log(cartaoCredito(true, "João Santos da Silva"));
// Gera objeto cartaoCredito com as propriedades:
// numero (sem máscara), bandeira, cvv, dataExpiracao e nomeTitular informado (abreviado)
console.log(cartaoCredito(false, "Maria Aparecida Reis"));
// Gera objeto cartaoCredito com as propriedades:
// numero (com máscara), bandeira, cvv, dataExpiracao e nomeTitular gerado (abreviado)
console.log(cartaoCredito(true, nome.femininoCompleto()));

Cuenta Bancaria

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
import { contaBancaria } from 'gerador-br'; // ES Module
// const { contaBancaria } = require('gerador-br'); // CommonJS
// Gera uma conta bancária aleatória de um banco aleatório
console.log(contaBancaria());
// Opcionalmente, atribua o objeto a uma variável e utilize as propriedades
const cb = contaBancaria();
console.log(cb.codigoBanco);
console.log(cb.nomeBanco);
console.log(cb.agencia);
console.log(cb.agenciaDv);
console.log(cb.conta);
console.log(cb.contaDv);
// Gera uma conta bancária aleatória do Banco do Brasil
console.log(contaBancaria('1'));
console.log(contaBancaria('Banco do Brasil'));
// Gera uma conta bancária aleatória do Bradesco
console.log(contaBancaria("237"));
console.log(contaBancaria('Bradesco'));
// Gera uma conta bancária aleatória da Caixa
console.log(contaBancaria('104'));
console.log(contaBancaria('Caixa'));
// Gera uma conta bancária aleatória do Citibank
console.log(contaBancaria('745'));
console.log(contaBancaria('Citibank'));
// Gera uma conta bancária aleatória do HSBC
console.log(contaBancaria('296'));
console.log(contaBancaria('HSBC'));
// Gera uma conta bancária aleatória do Itaú
console.log(contaBancaria('341'));
console.log(contaBancaria('Itaú'));
// Gera uma conta bancária aleatória do Santander
console.log(contaBancaria('33'));
console.log(contaBancaria('Santander'));

Personas

Ejemplos de uso para generar datos personales.

Nombre

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
import { nome } from 'gerador-br'; // ES Module
// const { nome } = require('gerador-br'); // CommonJS
// Gera um nome aleatório (feminino ou masculino)
console.log(nome.aleatorio());
// Gera um nome aleatório completo (feminino ou masculino)
console.log(nome.aleatorioCompleto());
// Gera um nome masculino aleatório
console.log(nome.masculino());
// Gera um nome masculino completo aleatório
console.log(nome.masculinoCompleto());
// Gera um nome feminino aleatório
console.log(nome.feminino());
// Gera um nome feminino completo aleatório
console.log(nome.femininoCompleto());
// Gera o nome da mãe aleatório
console.log(nome.mae());
// Gera o nome completo da mãe aleatório
console.log(nome.maeCompleto());
// Gera o nome do pai aleatório
console.log(nome.pai());
// Gera o nome completo do pai aleatório
console.log(nome.paiCompleto());
// Gera um nome do meio aleatório
console.log(nome.doMeio());
// Gera um sobrenome aleatório
console.log(nome.sobrenome());

Apodo

JS
1
2
3
4
5
import { apelido } from 'gerador-br'; // ES Module
// const { apelido } = require('gerador-br'); // CommonJS
// Gera apelido aleatório
console.log(apelido());

Fecha de Nacimiento

JS
1
2
3
4
5
6
7
import { dataNascimento } from 'gerador-br'; // ES Module
// const { dataNascimento } = require('gerador-br'); // CommonJS
// Gera data de nascimento aleatória
console.log(dataNascimento()); // Data entre 18-80 anos
console.log(dataNascimento(25)); // Data de quem tem exatamente 25 anos
console.log(dataNascimento([30, 40])); // Data entre 30-40 anos

Escolaridad

JS
1
2
3
4
5
import { escolaridade } from 'gerador-br'; // ES Module
// const { escolaridade } = require('gerador-br'); // CommonJS
// Gera escolaridade
console.log(escolaridade());

Profesión

JS
1
2
3
4
5
import { profissao } from 'gerador-br'; // ES Module
// const { profissao } = require('gerador-br'); // CommonJS
// Gera profissão
console.log(profissao());

Color de Piel

JS
1
2
3
4
5
import { corPele } from 'gerador-br'; // ES Module
// const { corPele } = require('gerador-br'); // CommonJS
// Gera cor de pele aleatória
console.log(corPele());

Tipo Sanguíneo

JS
1
2
3
4
5
import { tipoSanguineo } from 'gerador-br'; // ES Module
// const { tipoSanguineo } = require('gerador-br'); // CommonJS
// Gera tipo sanguíneo aleatório
console.log(tipoSanguineo());

Género

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import { genero } from 'gerador-br'; // ES Module
// const { genero } = require('gerador-br'); // CommonJS
// Retorna "Feminino"
console.log(genero('f'));
// Retorna "Masculino"
console.log(genero('m'));
// Retorna "Intersexo"
console.log(genero('i'));
// Retorna aleatoriamente "Masculino" ou "Feminino"
console.log(genero());
// Retorna aleatoriamente "Masculino" ou "Feminino"
console.log(genero(null));
// Retorna aleatoriamente "Masculino" ou "Feminino"
console.log(genero('x'));

Orientación Sexual

JS
1
2
3
4
5
import { orientacaoSexual } from 'gerador-br'; // ES Module
// const { orientacaoSexual } = require('gerador-br'); // CommonJS
// Gera uma orientação sexual aleatória.
console.log(orientacaoSexual()); // "Heterossexual", "Homossexual", "Bissexual", "Assexual", "Pansexual", etc.

Identidad de Género

JS
1
2
3
4
5
import { identidadeGenero } from 'gerador-br'; // ES Module
// const { identidadeGenero } = require('gerador-br'); // CommonJS
// Gera identidade de gênero aleatória.
console.log(identidadeGenero()); // "Cisgênero", "Transgênero" ou "Não binário"

Identidad de Género por Orientación Sexual

JS
1
2
3
4
5
6
7
8
9
import { identidadePorOrientacao } from 'gerador-br'; // ES Module
// const { identidadePorOrientacao } = require('gerador-br'); // CommonJS
console.log(identidadePorOrientacao('Heterossexual')); // 'Cisgênero' ou 'Transgênero'
console.log(identidadePorOrientacao('Homossexual')); // 'Cisgênero' ou 'Transgênero'
console.log(identidadePorOrientacao('Bissexual')); // 'Cisgênero', 'Transgênero' ou 'Não binário'
console.log(identidadePorOrientacao('Assexual')); // 'Cisgênero', 'Transgênero' ou 'Não binário'
console.log(identidadePorOrientacao('Pansexual')); // 'Cisgênero', 'Transgênero' ou 'Não binário'
console.log(identidadePorOrientacao()); // Retorna uma identidade de gênero aleatória associada a uma orientação sexual aleatória.

Contactos

Ejemplos de uso para generar información de contacto.

Email

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
import { email, nome } from 'gerador-br'; // ES Module
// const { email, nome } = require('gerador-br'); // CommonJS
// Gera e-mail com nickname aleatório
console.log(email());
// Gera e-mail com nome masculino
const nomeMasculinoCompleto = nome.masculinoCompleto();
console.log(email(nomeMasculinoCompleto));
// Gera e-mail com nome feminino
const nomeFemininoCompleto = nome.femininoCompleto();
console.log(email(nomeFemininoCompleto));

DDD

JS
1
2
3
4
5
6
7
8
import { ddd } from 'gerador-br'; // ES Module
// const { ddd } = require('gerador-br'); // CommonJS
// Gera DDD aleatório
console.log(ddd());
// Gera DDD aleatório do estado informado
console.log(ddd("PA"));

Código de Operadora

docGenerator.notes.portability

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import { codigoOperadora } from 'gerador-br'; // ES Module
// const { codigoOperadora } = require('gerador-br'); // CommonJS
// Gera um código da Claro (968, 973, 974, 975, 976, 991, 992, 993 ou 994)
console.log(codigoOperadora("Claro"));
// Gera um código da Oi (984, 985, 986, 987, 988 ou 989)
console.log(codigoOperadora("Oi"));
// Gera um código da Tim (969, 979, 980, 981, 982 ou 983)
console.log(codigoOperadora("Tim"));
// Gera um código da Vivo (967, 971, 972, 995, 996, 997, 998 ou 999)
console.log(codigoOperadora("Vivo"));
// Gera um código de uma operadora aleatória
console.log(codigoOperadora());
// Gera um código de uma operadora aleatória
console.log(codigoOperadora("blablabla"));

Celular

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
import { celular } from 'gerador-br'; // ES Module
// const { celular } = require('gerador-br'); // CommonJS
// Gera celular sem máscara, de estado aleatório e operadora aleatória
console.log(celular()); // "11999999999"
// Gera celular com máscara, de estado aleatório e operadora aleatória
console.log(celular(true)); // "(11) 99999-9999"
// Gera celular sem máscara, do estado informado e operadora aleatória
console.log(celular(false, "SC")); // "48999999999"
// Gera celular com máscara, do estado informado e operadora aleatória
console.log(celular(true, "ES")); // "(27) 99999-9999"
// Gera celular sem máscara, do estado aleatório e operadora informada
console.log(celular(false, "", "Claro")); // "85991999999"
// Gera celular com máscara, do estado informado e operadora informada
console.log(celular(true, "MS", "Vivo")); // "(67) 99799-9999"

Teléfono

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { telefone } from 'gerador-br'; // ES Module
// const { telefone } = require('gerador-br'); // CommonJS
// Gera telefone sem máscara, de estado aleatório
console.log(telefone()); // "1199999999"
// Gera telefone com máscara, de estado aleatório
console.log(telefone(true)); // "(11) 9999-9999"
// Gera telefone sem máscara, do estado informado
console.log(telefone(false, "SC")); // "4899999999"
// Gera telefone com máscara, do estado informado
console.log(telefone(true, "ES")); // "(27) 9999-9999"

CEP

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
import { cep } from 'gerador-br'; // ES Module
// const { cep } = require('gerador-br'); // CommonJS
// Gera CEP sem máscara de estado aleatório
console.log(cep()); // "12345678"
// Gera CEP com máscara de estado aleatório
console.log(cep(true)); // "12345-678"
// Gera CEP sem máscara de estado informado
console.log(cep(false, "SP")); // "01001000"
// Gera CEP com máscara de estado informado
console.log(cep(true, "SP")); // "01001-000"

Dirección

JS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
import { endereco } from 'gerador-br'; // ES Module
// const { endereco } = require('gerador-br'); // CommonJS
// Gera um objeto com todos os campos do endereço e de estado aleatório
console.log(endereco());
// Gera um objeto com todos os campos do endereço, o CEP com máscara e de estado aleatório
console.log(endereco(true));
// Gera um objeto com todos os campos do endereço, o CEP sem máscara e de estado aleatório
console.log(endereco(false));
// Gera um objeto com todos os campos do endereço, o CEP com máscara e do estado informado
console.log(endereco(true, "RJ"));
// Gera um objeto com todos os campos do endereço, o CEP sem máscara e do estado informado
console.log(endereco(false, "SP"));
// Opcionalmente, gere um endereço e utilize apenas a propriedade desejada
const end = endereco();
console.log(end.cep);
console.log(end.logradouro);
console.log(end.numero);
console.log(end.complemento); // caso exista
console.log(end.bairro);
console.log(end.localidade);
console.log(end.estado);

Vehículos

Ejemplos de uso para generar datos de vehículos.

Matrícula Antigua

JS
1
2
3
4
5
6
7
8
import { placaAntiga } from 'gerador-br'; // ES Module
// const { placaAntiga } = require('gerador-br'); // CommonJS
// Gera placa no formato antigo com máscara "ABC-1234"
console.log(placaAntiga(true));
// Gera placa no formato antigo sem máscara "ABC1234"
console.log(placaAntiga(false));

Matrícula Mercosur

JS
1
2
3
4
5
6
7
8
import { placaMercosul } from 'gerador-br'; // ES Module
// const { placaMercosul } = require('gerador-br'); // CommonJS
// Gera placa no formato Mercosul com máscara "ABC-1D23"
console.log(placaMercosul(true));
// Gera placa no formato Mercosul sem máscara "ABC1D23"
console.log(placaMercosul(false));

RENAVAM

JS
1
2
3
4
5
import { renavam } from 'gerador-br'; // ES Module
// const { renavam } = require('gerador-br'); // CommonJS
// Gera RENAVAM
console.log(renavam());

Lorem Ipsum

Ejemplos de uso para generar textos genéricos.

Palabra

JS
1
2
3
4
5
import { palavra } from 'gerador-br'; // ES Module
// const { palavra } = require('gerador-br'); // CommonJS
// Gera uma palavra aleatória
console.log(palavra());

Frase

JS
1
2
3
4
5
6
7
8
import { sentenca } from 'gerador-br'; // ES Module
// const { sentenca } = require('gerador-br'); // CommonJS
// Gera uma sentença com quantidade de palavras aleatórias
console.log(sentenca());
// Gera uma sentença com quantidade de palavras definida
console.log(sentenca(10));

Párrafos

JS
1
2
3
4
5
6
7
8
9
10
11
import { paragrafo } from 'gerador-br'; // ES Module
// const { paragrafo } = require('gerador-br'); // CommonJS
// Gera um parágrafo com quantidade de palavras aleatórias
console.log(paragrafo());
// Gera um parágrafo com quantidade de sentença informada, cada uma com quantidade de palavras aleatórias
console.log(paragrafo(5));
// Gera um parágrafo com quantidade de sentenças e de palavras informadas.
console.log(paragrafo(3, 8));

Preguntas Frecuentes (FAQ)