Título de Eleitor
Valide Título de Eleitor e gere números de teste com JavaScript e TypeScript.
Use o validador de Título de Eleitor para conferir os dois dígitos verificadores, o gerador de títulos automático para criar exemplos em testes automatizados, e veja a implementação completa em JavaScript, TypeScript e Node.js com a validation-br. É o documento que comprova o registro de um eleitor perante a Justiça Eleitoral e o habilita a votar — também aceito como identificação em diversos serviços. É emitido pelo TSE e costuma ser exigido em concursos públicos, cadastros de programas sociais e outros serviços que pedem comprovação de situação eleitoral regular.
Exemplos (API)
import { TituloEleitor } from 'validation-br/tituloEleitor';
// Criar e validar (lança se inválido)
const t = new TituloEleitor('5250.2888.1694');
t.value; // -> '525028881694'
t.toString(); // -> '525028881694'
t.mask(); // -> '5250.2888.1694'
// Gerar um Título de exemplo válido
const exemplo = TituloEleitor.fake();
exemplo.mask();
// Calcular checksum (10 primeiros dígitos: 8 sequenciais + 2 da UF)
TituloEleitor.checksum('5250288816'); // -> '94'Como o cálculo é feito
O Título de Eleitor tem 12 dígitos: 8 sequenciais + 2 da UF + 2 dígitos verificadores. O DV1 usa os 8 dígitos sequenciais com pesos de 2 a 9; o DV2 usa os 2 dígitos da UF + o DV1 calculado, com pesos 7, 8 e 9. Em ambos os casos, o dígito verificador é o resto direto da divisão por 11 (sem o passo 11 - resto usado no CPF/CNPJ).
