Validações de forma fácil ✅

Leia isso em outras línguas: English

Visão geral

Validations BR é um cinto de ferramentas de funções para validar documentos padrões no Brasil e mais.

Instalação

Com npm:

1npm install validations-br

Com yarn:

1yarn add validations-br

Como usar

useValidationsBR

Parâmetros

Chave	Tipo	Descrição
type	cnpj | cpf | cep | email | pis | phone | uf	Tipo de dados que serão validados
value	string	Valor que será validado

1import { useValidationsBR } from 'validations-br';
2// const { useValidationsBR } = require('validations-br');
3
4const cnpj = '09.015.844/0001-80';
5const isValid = useValidationsBR('cnpj', cnpj);

Validar CNPJ

1import { validateCNPJ } from 'validations-br';
2// const { validateCNPJ } = require('validations-br');
3
4
5const cnpj = '09.015.844/0001-80';
6const isValid = validateCNPJ(cnpj);

Validar CPF

1import { validateCPF } from 'validations-br';
2// const { validateCPF } = require('validations-br');
3
4const cpf = '370.785.180-04';
5const isValid = validateCPF(cpf);

Validar Inscrição Estadual

1import { validateIE } from 'validations-br';
2// const { validateIE } = require('validations-br');
3
4const ie = '535.371.880.779';
5const isValid = validateIE(ie, 'sp');

Validar PIS/PASEP

1import { validatePIS } from 'validations-br';
2// const { validatePIS } = require('validations-br');
3
4const pis = '833.28281.34-7';
5const isValid = validatePIS(pis);

Validar CNH

1import { validateCNH } from 'validations-br';
2// const { validateCNH } = require('validations-br');
3
4const cnh = '134621966-24';
5const isValid = validateCNH(cnh);

Validar Telefone

1import { validatePhone } from 'validations-br';
2// const { validatePhone } = require('validations-br');
3
4const phone = '(14) 99767-9472';
5const isValid = validatePhone(phone);

Validar CEP

1import { validateCEP } from 'validations-br';
2// const { validateCEP } = require('validations-br');
3
4const cep = '17280-000';
5const isValid = validateCEP(cep);

Validar UF

1import { validateUF } from 'validations-br';
2// const { validateUF } = require('validations-br');
3
4const uf = 'SP';
5const isValid = validateUF(uf);

Bônus

Validar E-mail

1import { validateEmail } from 'validations-br';
2// const { validateEmail } = require('validations-br');
3
4const email = 'johndoe@gmail.com';
5const isValid = validateEmail(email);

Integrações

Com Yup

1import { validateCNPJ } from "validations-br";
2import * as Yup from "yup";
3
4try {
5  const schema = Yup.string().test(
6    "is-cnpj",
7    "CNPJ is not valid",
8    (value) => validateCNPJ(value)
9  );
10  
11  await schema.validate(cnpj);
12} catch(err) {
13  console.log(err.message);
14}

Com Joi

1import { validateCNPJ } from "validations-br";
2import Joi from "joi";
3
4try {
5  const schema = Joi.string().custom(validateCNPJ, "Validate CNPJ");
6
7  const { value } = schema.validate(cnpj);
8
9  if (!value) {
10    throw Error("CNPJ is not valid");
11  }
12} catch(err) {
13  console.log(err.message);
14}

Como contribuir

Fique a vontade para contribuir com o projeto. Nós só pedimos para que:

• Dê fork (https://github.com/reactivando/validations-br/fork)
• Crie sua branch da feature/fix (git checkout -b feature/fooBar)
• Escreva os testes para a nova feature ou do bug fix resolvido
• Faça o commit das mudanças (git commit -am 'feat: add some fooBar')
• Siga os padrões de commit conventional-changelog descritos em conventional-conventions
• Dê push dá branch para seu repositório (git push origin feature/fooBar)
• Tenha certeza que os testes passaram antes de abrir a pull-request (Use: $ yarn test or $ npm run test)
• Crie uma nova Pull Request

Autores

• André Zagatti @azagatti

• Ariel Franco @arielff3

Licença

MIT © Reactivando