search

mariohmol / 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
http://geradorbrasileiro.com
MIT License
240 stars 38 forks source link

readme

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="https://github.com/mariohmol/js-brasil/raw/master/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

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="https://github.com/mariohmol/js-brasil/raw/master/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="https://github.com/mariohmol/js-brasil/raw/master/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="https://github.com/mariohmol/js-brasil/raw/master/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:

React

Utilize com React:

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