Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

Last synced: 1 day ago
JSON representation

Host: GitHub
URL: https://github.com/mariohmol/js-brasil
Owner: mariohmol
License: mit
Created: 2018-09-19T00:12:33.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-09-26T02:59:46.000Z (about 2 months ago)
Last Synced: 2024-10-29T01:25:38.874Z (17 days ago)
Language: TypeScript
Homepage: http://geradorbrasileiro.com
Size: 660 KB
Stars: 238
Watchers: 8
Forks: 38
Open Issues: 14
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

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](https://travis-ci.org/mariohmol/js-brasil.svg?branch=master)](https://travis-ci.org/mariohmol/js-brasil)

`npm i js-brasil` 

 ou 

``

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

Plugins para :

* [Angular](https://github.com/mariohmol/ng-brazil) 

* [React](https://github.com/mariohmol/react-brazil)

* [Vue](https://github.com/mariohmol/vue-brazil)

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:

```js

const { validateBr } = require('js-brasil');

const cpf = validateBr.cpf('123.456.789-00');

```

Typescript:

```ts

import { validateBr } from 'js-brasil';

const cpf = validateBr.cpf('123.456.789-00');

```

Browser:

```html

var cpf = jsbrasil.validateBr.cpf('123.456.789-00');

  

```

# MaskBR

Formate seus dados com mascaras de tipos de dados brasileiros

Node:

```js

const { maskBr } = require('js-brasil');

const cpf = maskBr.cpf('12345678900'); 

console.info(cpf) // '123.456.789-00'

```

Typescript:

```ts

import { maskBr } from 'js-brasil';

const cpf = maskBr.cpf('12345678900'); 

console.info(cpf) // '123.456.789-00'

```

Browser:

```html

var cpf = jsbrasil.maskBr.cpf('12345678900'); 

console.info(cpf) // '123.456.789-00'

  

```

# UtilsBR

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

```ts

  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:

```js

const { utilsBr } = require('js-brasil');

const currency = utilsBr.currencyToNumber(' R$ 1.234.456,44 '); // 1234456.44

const percent2 = utilsBr.currencyToNumber(' 12 % '); // 12

```

Typescript:

```ts

import { utilsBr } from 'js-brasil';

const currency = utilsBr.currencyToNumber(' R$ 1.234.456,44 ');

const percent2 = utilsBr.currencyToNumber(' 12 % '); // 12

```

Browser:

```html

var currency = jsbrasil.utilsBr.currencyToNumber(' 12 % '); // 12

  

```

# FakerBR

[FakerBR](https://github.com/mariohmol/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](CONTRIBUTING.md)