CEP Callback
Busca por CEP usando o melhor do JavaScript, callbacks
Todos sabem que hoje as Promises dominam o mundo do JavaScript. O que faz com que a utilização de callbacks seja algo do passado. Porém o oldschool é sempre mais legal, portanto essa biblioteca mostra como callbacks ainda podem ser utilizados e como você pode se sentir um hipster ao utilizá-las em 2018.
Features
- Interface com callbacks seguindo o padrão da biblioteca padrão do
Node.js
- Possui a mesma interface tanto nos erros como nas respostas do projeto cep-promise
- O projeto utiliza de
var
que é o jeito da massa de se criar variáveis em JavaScript, sim isso é uma feature
Como utilizar
Realizando uma consulta
Por ser multifornecedor, a biblioteca irá chamar o callback com o fornecedor que mais rápido lhe responder.
var cep =// {// "cep": "05010000",// "state": "SP",// "city": "São Paulo",// "street": "Rua Caiubí",// "neighborhood": "Perdizes",// }
Você também poderá passar o CEP como Inteiro
Em muitos sistemas o CEP é utilizado erroneamente como um Inteiro (e com isto cortando todos os zeros à esquerda). Caso este seja o seu caso, não há problema, pois a biblioteca irá preencher os caracteres faltantes na String, por exemplo:
var cep =// enviando sem ter um zero à esquerda do CEP "05010000"// {// "cep": "05010000",// "state": "SP",// "city": "São Paulo",// "street": "Rua Caiubí",// "neighborhood": "Perdizes",// }
Quando o CEP não é encontrado
Neste caso será retornado um "service_error"
e por ser multifornecedor, a biblioteca irá retornar um erro no callback apenas quando tiver a resposta negativa de todos os fornecedores.
var cep =// {// name: 'CepPromiseError',// message: 'Todos os serviços de CEP retornaram erro.',// type: 'service_error',// errors: [{// message: 'CEP NAO ENCONTRADO',// service: 'correios'// }, {// message: 'CEP não encontrado na base do ViaCEP.',// service: 'viacep'// }, {// message: 'CEP não encontrado na base do Cep Aberto.',// service: 'cepaberto'// }]// }
Quando o CEP possui um formato inválido
Neste caso será retornado um "validation_error"
e a biblioteca irá retornar um erro no callback, sem chegar a consultar nenhum fornecedor.
var cep =// {// name: 'CepPromiseError',// message: 'CEP deve conter exatamente 8 caracteres.',// type: 'validation_error',// errors: [{// message: 'CEP informado possui mais do que 8 caracteres.',// service: 'cep_validation'// }]// }
Instalação
Browser usando CDN
<script src="https://cdn.jsdelivr.net/npm/cep-callback/src/index.js"></script>
npm
$ npm install --save cep-callback
Bower
$ bower install --save cep-callback
Angular 2
cep'05010000',
Como contribuir
Leia nosso guia de contribuição aqui
Contribuidores
Ainda não temos, venha contribuir! :)
Autor
@otaviopace |
---|