0.1.0 • Published 7 years ago
brjs v0.1.0
br.js
Em desenvolvimento Validador de strings para formatos e padrões brasileiros
Por quê ?
É cansativo e trabalhoso ter que buscar e utilizar libs separadas para validações e utilizações de padrões brasileiros, como cpf, cnpj, cep, números de telefone, etc. Embora este módulo não seja uma novidade, pois você vai encontrar libs separadas que fazem validações do tipo, a proposta aqui é unificar as validações comuns de padrões brasileiros em um único módulo, afim de poupar tempo buscando e utilizando diferentes módulos no seu projeto.
Instalação
Npm:
npm install brjs --save
Validadores
Validadores disponíveis:
Validador | Descrição |
---|---|
cep.isValid(str) | Verifica se string é um CEP válido com ou sem "-" |
phoneNumber.isValid(str) | Verifica se string é um número de celular válido com DDD |
Exemplos de Validadores:
var br = require('brjs')
/* CEP */
br.cep.isValid('60135-222')
//=> true
br.cep.isValid('60135222')
//=> true
// Com tamanho de string inválido
br.cep.isValid('6013522')
//=> false
/* Número de Celular */
br.phoneNumber.isValid('85998283344')
//=> true
// Com tamanho de string inválido
br.phoneNumber.isValid('8599828334')
//=> false
// Com números repetidos
br.phoneNumber.isValid('85999999999')
//=> false
// Com DDD inválido
br.phoneNumber.isValid('1099828334')
//=> false
Utilitários
Lista de utilitários disponíveis:
Utilitário | Descrição |
---|---|
cep.search(str, function(error, response)) | Callback para realizar busca de cep na base dos correios |
Exemplos de Utilitários:
var br = require('brjs')
br.cep.search( '60135-222', function(error, response) {
if(response.statusCode == 200){
console.log(response.body)
/*
=> {
complemento: 'de 700/701 ao fim',
bairro: 'Dionisio Torres',
cidade: 'Fortaleza',
logradouro: 'Rua Marcondes Pereira',
estado_info: {
area_km2: '148.887,632', codigo_ibge: '23', nome: 'Ceará'
},
cep: '60135222',
cidade_info: {
area_km2: '314,93', codigo_ibge: '2304400'
},
estado: 'CE'
}
*/
} else {
// Retorna status 404 para cep não localizado
console.log(response.statusCode)
}
})
Lista de funcionalidades implementadas e pendentes
Qualquer ajuda é bem-vinda, seja para implementar funcionalidades pendentes ou sugeridas por você.
Validadores Disponíveis
Endereço
CEP
Números de telefone celular
DDD + Número de telefone
Número de documentos
- CPF
- CNPJ
- RG
Contas bancárias
- Número de agência
- Dígito da agência
- Conta corrente
- Dígito da conta corrente
Utilitários
Busca de CEP na base dos correios
Testes
npm test