Skip to content

validation-brValide documentos brasileiros sem reinventar a roda.

CPF, CNPJ, CNH, PIS/PASEP, Título de Eleitor, RENAVAM, processos judiciais, protocolos do governo e rastreio dos Correios — tudo com uma API orientada a classes e zero dependências.

Em ação

Simples assim

import { isCPF } from 'validation-br';
import { CPF } from 'validation-br/cpf';

// Modo rápido
isCPF('098.765.432-10'); // true

// Modo Value-Object
const cpf = new CPF('098.765.432-10');
cpf.value; // '09876543210'
Primeira no Brasil

A primeira biblioteca com suporte ao CNPJ alfanumérico

A partir da Nota Técnica conjunta COCAD/SUARA/RFB nº 49, de 14 de maio de 2024, os números de CNPJ poderão conter letras. A mudança entra em uso em 2026 — e o validation-br já valida os dois formatos.

Ver documentação do CNPJ
import { CNPJ } from 'validation-br/cnpj';

// Gera um CNPJ alfanumérico de exemplo
CNPJ.fake({ alphanumeric: true }).mask();
// -> 'WX.BC2.1FX/0001-00'

new CNPJ('WX.BC2.1FX/0001-00').value;
// -> 'WXBC21FX000100'
O que valida

Vinte tipos de documento, uma API só

CPF
import { isCPF } from 'validation-br';
import { CPF } from 'validation-br/cpf';

// Modo rápido
isCPF('280.012.389-38'); // -> true

// Modo Value-Object
const cpf = new CPF('280.012.389-38');
cpf.value;      // -> '28001238938'
cpf.toString(); // -> '28001238938'
cpf.mask();     // -> '280.012.389-38'
Ver documentação de CPF