js-brasil icon indicating copy to clipboard operation
js-brasil copied to clipboard

Javascript Validate, Mask, Faker e Utils para Tipos do Brasil: Celular, CEP, Certidão, CNH, CNPJ, CNS, CPF, Currency, Date, ECT, EMAIL, Empresa, Endereço, Inscrição Estadual, Number, Percentage, Pesso...

js-brasil

Javascript Validate, Mask, Faker e Utils para Tipos do Brasil: Celular, CEP, Certidão, CNH, CNPJ, CNS, CPF, Currency, Date, ECT, EMAIL, Empresa, Endereço, Inscrição Estadual, Number, Percentage, Pessoa, PIS/PASEP, Placa de carro, Processo da justiça, RENAVAM , RG , Site, Telefone , Time (data/hora), Título de Eleitor , Veículo

Build Status

npm i js-brasil

ou

<script src="js-brasil.js"></script>

Módulos ValidateBR, MaskBR e FakerBR para nodejs ou browser.

Plugins para :

Veja tudo em ação no Gerador Brasileiro - http://geradorbrasileiro.com/

Ou veja um exemplo de código live: https://jsfiddle.net/mariohmol/qnmxhwrb/6/

Tipos Suportados

  • Cartão de Crédito - http://geradorbrasileiro.com/cartao.html (TODO #12)
  • Celular - http://geradorbrasileiro.com/celular.html
  • CEP - http://geradorbrasileiro.com/cep.html
  • Certidão - http://geradorbrasileiro.com/certidao.html
  • CID - http://geradorbrasileiro.com/cid.html (TODO #34)
  • CNAE - http://geradorbrasileiro.com/cnae.html (TODO #16)
  • CNH - http://geradorbrasileiro.com/cnh.html
  • CNPJ - http://geradorbrasileiro.com/cnpj.html
  • CNS - http://geradorbrasileiro.com/cns.html
  • Conta de Banco - http://geradorbrasileiro.com/contato.html (TODO #13)
  • CPF - http://geradorbrasileiro.com/cpf.html
  • CPF/CNPF - http://geradorbrasileiro.com/cpfcnpj.html (TODO #15)
  • Currency - http://geradorbrasileiro.com/others.html
  • Data/Date/DataHora/Datetime - http://geradorbrasileiro.com/data.html
  • ECT - http://geradorbrasileiro.com/ect.html
  • EMAIL - http://geradorbrasileiro.com/email.html
  • Empresa - http://geradorbrasileiro.com/empresa.html
  • Endereço - http://geradorbrasileiro.com/endereco.html
  • Inscrição Estadual - http://geradorbrasileiro.com/inscricaoestadual.html - Todos os estados do Brasil
  • IPTU - http://geradorbrasileiro.com/iptu.html (TODO #26)
    • São Paulo e Curitiba OK
    • Outras capitais (TODO)
  • NIT - (TODO #14)
  • Number - http://geradorbrasileiro.com/others.html
  • Percentage - http://geradorbrasileiro.com/others.html
  • Pessoa - http://geradorbrasileiro.com/pessoa.html
  • PIS/PASEP - http://geradorbrasileiro.com/pis.html
  • Placa de carro - http://geradorbrasileiro.com/placa.html
  • Processo da justiça - http://geradorbrasileiro.com/processo.html
  • RENAVAM - http://geradorbrasileiro.com/renavam.html
  • RG - http://geradorbrasileiro.com/rg.html
    • SP/RJ - OK
    • Outros estado (TODO)
  • Site - http://geradorbrasileiro.com/site.html
  • SPED - http://geradorbrasileiro.com/sped.html (TODO: #24)
  • Telefone - http://geradorbrasileiro.com/telefone.html
  • Time (data/hora) - http://geradorbrasileiro.com/others.html
  • Título de Eleitor - http://geradorbrasileiro.com/titulo.html
  • Veículo - http://geradorbrasileiro.com/veiculo.html

ValidateBR

Verifique se os dados dos seus usuários são válidos

Node:

const { validateBr } = require('js-brasil');
const cpf = validateBr.cpf('123.456.789-00');

Typescript:

import { validateBr } from 'js-brasil';
const cpf = validateBr.cpf('123.456.789-00');

Browser:

<script src="js-brasil.js"></script>
<script>
var cpf = jsbrasil.validateBr.cpf('123.456.789-00');
</script>  

MaskBR

Formate seus dados com mascaras de tipos de dados brasileiros

Node:

const { maskBr } = require('js-brasil');
const cpf = maskBr.cpf('12345678900'); 
console.info(cpf) // '123.456.789-00'

Typescript:

import { maskBr } from 'js-brasil';
const cpf = maskBr.cpf('12345678900'); 
console.info(cpf) // '123.456.789-00'

Browser:

<script src="js-brasil.js"></script>
<script>
var cpf = jsbrasil.maskBr.cpf('12345678900'); 
console.info(cpf) // '123.456.789-00'
</script>  

UtilsBR

Métodos úteis para todos apps brasileiros, veja alguns exemplos

  const currency = utilsBr.currencyToNumber(' R$ 1.234.456,44 ');
  expect(currency).to.be.equal(1234456.44);
  const percent = utilsBr.currencyToNumber(' 1.234.456,44%');
  expect(percent).to.be.equal(1234456.44);
  const percent2 = utilsBr.currencyToNumber(' 12 % ');
  expect(percent2).to.be.equal(12);

Node:

const { utilsBr } = require('js-brasil');
const currency = utilsBr.currencyToNumber(' R$ 1.234.456,44 '); // 1234456.44
const percent2 = utilsBr.currencyToNumber(' 12 % '); // 12

Typescript:

import { utilsBr } from 'js-brasil';
const currency = utilsBr.currencyToNumber(' R$ 1.234.456,44 ');
const percent2 = utilsBr.currencyToNumber(' 12 % '); // 12

Browser:

<script src="js-brasil.js"></script>
<script>
var currency = jsbrasil.utilsBr.currencyToNumber(' 12 % '); // 12
</script>  

FakerBR

FakerBR é um gerador de dados de teste usando tipos de dados brasileiro, similar o fakerjs agora tem um repositório próprio para deixar o js-brasil bem enxuto em mask e validation.

Angular

Utilize em angular 2 a 8 com:

  • ng-brazil - angular support for brazil apps - https://github.com/mariohmol/ng-brazil

React

Utilize com React:

  • react-brazil - react support for brazil apps - https://github.com/mariohmol/react-brazil

API

Quer usar estes métodos através de uma API Web? Entre em contato conosco!

Contribuir

Para ajudar veja nossa issues e use a seguinte documentação: Contribuir