Pular para o conteúdo principal

Documentation Gerador-BR

La bibliothèque de données brésilienne définitive pour vos tests Node.js. Tests d'assurance qualité.

Installez le package gerador-br NPM et ne vous souciez plus des données de test. Léger, sans dépendances et couverture complète des données fictives pour vos tests.

NPM VersionNPM Downloads

Commencer

À propos de Gerador-BR

Générateur de données fictives brésiliennes

Générez des données fictives/valides pour les tests et le développement de logiciels.

Idéal pour les tests automatisés avec Cypress, Playwright, Jest, Node.js Test Runner, Jasmine, Mocha, Chai, Supertest, Sinon et Puppeteer.

Installation

Shell
npm install gerador-br

Ou

Shell
yarn add gerador-br

Importer

Module ES :

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

CommonJS :

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

Usage

Importez uniquement la ou les fonctions dont vous avez besoin :

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());

Ou importez l'intégralité du module 'gerar' et utilisez la fonction de votre choix :

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());

Documents personnels

Exemples d'utilisation pour générer des documents Personne individuelle.

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));

Carte d'électeur

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'));

Passeport

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());

Certificat

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

Documents de l'entreprise

Exemples d'utilisation pour générer des documents d'entité juridique.

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 alphanumérique

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));

Enregistrement d'État

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

Nom de l'entreprise

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"

Banques

Exemples d'utilisation pour générer des données bancaires.

Banque

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));

Liste des codes bancaires

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());

Carte de crédit

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()));

Compte bancaire

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'));

Personnes

Exemples d'utilisation pour générer des données personnelles.

Nom

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());

Surnom

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());

Date de naissance

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

Éducation

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

Profession

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());

Couleur de la peau

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());

Groupe sanguin

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());

Genre

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'));

Orientation sexuelle

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.

Identité de genre

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"

Identité de genre par orientation sexuelle

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.

Contacts

Exemples d'utilisation pour générer des informations de contact.

E-mail

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"));

Code du transporteur

Remarque : La portabilité du numéro n’est pas prise en compte ; le numéro de téléphone mobile est généré uniquement sur la base des numéros d'origine des opérateurs.

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"));

Mobile

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"

Téléphone

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"

Adresse

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);

Véhicules

Exemples d'utilisation pour générer des données sur les véhicules.

Ancienne plaque d'immatriculation

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));

Plaque d'immatriculation du Mercosul

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

Exemples d'utilisation pour générer des textes génériques.

Mot

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());

Phrase

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));

Paragraphes

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));

Foire aux questions (FAQ)