CPF

Valide CPF e gere números de teste com JavaScript e TypeScript.

Use o validador de CPF para conferir o dígito verificador, o gerador de CPF automático para criar números fake em testes e seeds, e veja a implementação completa em JavaScript, TypeScript e Node.js com a validation-br. O CPF identifica uma pessoa física perante a Receita Federal e é exigido em contratos, cadastros e serviços financeiros em todo o Brasil.

Gerar CPF de exemplo

Máscara

059.616.903-50

Exemplos (API)

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

// Criar e validar (lança se inválido)
const cpf = new CPF('280.012.389-38');
cpf.value;        // -> '28001238938'
cpf.toString();   // -> '28001238938'
cpf.mask();       // -> '280.012.389-38'

// Gerar um CPF de exemplo válido
const exemplo = CPF.fake();
exemplo.toString();

// Calcular checksum a partir dos 9 primeiros dígitos
CPF.checksum('280012389'); // -> '38'

Como o cálculo é feito

O CPF tem 11 dígitos: os 8 primeiros são um número sequencial definido pela Receita Federal, o 9º indica a região fiscal emissora, e os 2 últimos são dígitos verificadores (DV) calculados a partir dos anteriores.

Região fiscal (9º dígito):

Dígito	Região
1	DF, GO, MS, MT e TO
2	AC, AM, AP, PA, RO e RR
3	CE, MA e PI
4	AL, PB, PE, RN
5	BA e SE
6	MG
7	ES e RJ
8	SP
9	PR e SC
0	RS

Se o resto da divisão por 11 for 10, o dígito verificador é considerado 0.