@eklesia/cpf-cnpj-validator

Valida e formata strings de CPF ou CNPJ.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
@eklesia/cpf-cnpj-validator
000.1.1-eklesia.24 years ago4 years agoMinified + gzip package size for @eklesia/cpf-cnpj-validator in KB

Readme

cpf-cnpj-validator
Valida e formata strings de CPF ou CNPJ. !travistravis-imagetravis-url !npmnpm-imagenpm-url

Instalação:

``` npm i cpf-cnpj-validator -S ```

Note:

Requer Node `>=8.0.0`.

Uso:

```js const { cpf } = require('cpf-cnpj-validator'); // gera um número de cpf const num = cpf.generate(); // #=> 25634428777 // verifica se é um número válido cpf.isValid(num); // #=> true // formata o número gerado cpf.format(num); // #=> 256.344.287-77 ``` NOTE: os módulos de cpf e cnpj possuem métodos nomeados de forma igual diferindo se apenas os resultados. ```js const { cnpj } = require('cpf-cnpj-validator'); // gera um número de cpnj const num = cnpj.generate(); // #=> 58403919000106 // verifica se é um número válido cnpj.isValid(num); // #=> true // formata o número gerado cnpj.format(num); // #=> 58.403.919/0001-06 ``` Veja mais exemplos práticos consultando os testes para CPF e CNPJ.

Joi

@hapi/joi é uma excelente biblioteca para validação de objetos javascript que permite a construção de mecanismos personalizados para tal. A biblioteca cpf-cnpj-validator disponibiliza um mecanismo personalizado para Joi capas de validar se uma string pode ser, ou não, um número válido de CPF ou CNPJ: ```js const validator = require('cpf-cnpj-validator') // or // const { validator } = require('cpf-cnpj-validator') // const Joi = require('@hapi/joi').extend(validator) const cnpjSchema = Joi.document().cnpj(); const cpfSchema = Joi.document().cpf(); // valida o CPF Joi.validate('54271113107', cpfSchema); // #=> true // valida o CNPJ Joi.validate('38313108000107', cnpjSchema); // #=> true ``` Maiores informações podem ser obtidas com os testes de validação 1 e validação 2.

Tests

```shell npm test ```

License

MIT Copyright (c) 2018-present