Validar CNH em Node.js

Rota 1: validar CNH em Node.js com o algoritmo local

Versão completa com o desconto do segundo dígito comentado. Aceita espaços, pontos e hífen, e rejeita os 11 dígitos iguais.

// validador-cnh.mjs (ES modules, Node 18+, zero dependências)
import { fileURLToPath } from 'node:url';

/** Valida o número de registro da CNH (11 dígitos) pelo mod-11 do DENATRAN. */
export function validaCnh(cnh) {
  const s = String(cnh).replace(/[\s.-]/g, '');
  if (!/^\d{11}$/.test(s) || new Set(s).size === 1) return false;
  const d = s.split('').map(Number);
  const base = d.slice(0, 9);

  // 1º DV: pesos 9 a 1 sobre os 9 primeiros dígitos
  let dv1 = base.reduce((acc, n, i) => acc + n * (9 - i), 0) % 11;
  let dsc = 0;
  if (dv1 >= 10) { // resto 10: DV vira 0 e o 2º DV sofre desconto de 2
    dv1 = 0;
    dsc = 2;
  }

  // 2º DV: pesos 1 a 9 sobre os mesmos 9 dígitos, menos o desconto
  let dv2 = (base.reduce((acc, n, i) => acc + n * (i + 1), 0) % 11) - dsc;
  if (dv2 < 0) dv2 += 11;
  if (dv2 >= 10) dv2 = 0;

  return d[9] === dv1 && d[10] === dv2;
}

if (process.argv[1] === fileURLToPath(import.meta.url)) {
  for (const cnh of ['123 456 789 00', '12345678900', '987.654.321-09', '123 456 789 01', '123 456 702 02']) {
    console.log(cnh.padEnd(16), validaCnh(cnh));
  }
}

Como o cálculo do dígito verificador da CNH funciona

Um exemplo calculado à mão, para você conferir o código contra a conta.

CNH 123 456 789 00

1º DV: 1×9 + 2×8 + 3×7 + 4×6 + 5×5 + 6×4 + 7×3 + 8×2 + 9×1
      = 165
      165 mod 11 = 0  ->  DV1 = 0, desconto 0

2º DV: 1×1 + 2×2 + 3×3 + 4×4 + 5×5 + 6×6 + 7×7 + 8×8 + 9×9
      = 285
      285 mod 11 = 10  ->  resultado >= 10 vira 0

Caso do desconto: CNH 123 456 702 02

1º DV: 1×9 + 2×8 + 3×7 + 4×6 + 5×5 + 6×4 + 7×3 + 0×2 + 2×1
      = 142
      142 mod 11 = 10 (>= 10)  ->  DV1 = 0 e desconto = 2

2º DV: 1×1 + 2×2 + 3×3 + 4×4 + 5×5 + 6×6 + 7×7 + 0×8 + 2×9
      = 158
      158 mod 11 = 4, menos o desconto 2 = 2  ->  DV2 = 2

Rota 2: conferir o validador com CNHs da API do FakeForge

A API do FakeForge gera CNHs válidas, mas não tem endpoint de validação. Use o lote gerado como oráculo de teste: todas precisam passar no seu validador, e com o último dígito trocado precisam falhar.

// confere-cnh-api.mjs (Node 18+). Salve o validador da Rota 1 como validador-cnh.mjs
import { validaCnh } from './validador-cnh.mjs';

const res = await fetch('https://fakeforge.com.br/api/generate?type=cnh&quantity=30');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { data: cnhs } = await res.json();

const trocaUltimoDigito = (cnh) => cnh.slice(0, -1) + ((Number(cnh.at(-1)) + 1) % 10);

const rejeitadasIndevidas = cnhs.filter((c) => !validaCnh(c));
const aceitasIndevidas = cnhs.filter((c) => validaCnh(trocaUltimoDigito(c)));

console.log(`${cnhs.length} CNHs da API | válidas rejeitadas: ${rejeitadasIndevidas.length} | inválidas aceitas: ${aceitasIndevidas.length}`);
if (rejeitadasIndevidas.length || aceitasIndevidas.length) process.exit(1);

Como testar o validador de CNH com Jest

Com Jest em modo ESM. Os casos cobrem válidos, inválidos e as bordas de CNH.

// validador-cnh.test.mjs (Jest)
import { validaCnh } from './validador-cnh.mjs';

describe('validaCnh', () => {
  test.each([
    '123 456 789 00',
    '12345678900',
    '987.654.321-09',
    '123 456 702 02', // caso do desconto: 1º DV com resto 10 vira 0 e o 2º perde 2
  ])('aceita %s', (cnh) => {
    expect(validaCnh(cnh)).toBe(true);
  });

  test.each([
    '123 456 789 01', // 2º DV errado
    '123 456 789 10', // 1º DV errado
    '111 111 111 11', // repetidos
    '123 456 789 0', // curto demais
    '',
  ])('rejeita %p', (cnh) => {
    expect(validaCnh(cnh)).toBe(false);
  });
});

Validar CNH: algoritmo local ou serviço externo

Perguntas frequentes sobre validar CNH em Node.js

Páginas relacionadas