cpf-cnpj-validator

Valida e formata strings de CPF ou CNPJ.

Instalação:

npm i cpf-cnpj-validator -S

Note:

Requer Node >=8.0.0.

Uso:

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.

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:

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

npm test

License

MIT

Copyright (c) 2018-present