Validador y formateador de RUT (Rol Único Tributario) chileno para JavaScript y TypeScript.
- ✅ Sin dependencias
- ✅ Tree-shakable
- ✅ Compatible con ESM y CommonJS
- ✅ Soporte completo para TypeScript
- ✅ Implementación módulo 11 correcta
- ✅ Ultra liviano (< 1KB gzip)
🇪🇸 Español | 🇺🇸 English
npm install rut-clEl RUT debe contener un guion - separando el cuerpo del dígito verificador. Los puntos son opcionales.
import { validate } from 'rut-cl'
validate('12.345.678-5') // true
validate('12345678-5') // true
validate('123456785') // false (guion obligatorio)
validate('12,345,678-5') // false (caracteres inválidos)import { format } from 'rut-cl'
format('123456785') // '12.345.678-5'Opciones:
// Personalizar separadores
format('12345678K', { dots: ',', hyphen: '/' }) // '12,345,678/K'
// Sin puntos
format('123456785', { dots: false }) // '12345678-5'
// Sin guion
format('12345678K', { hyphen: false }) // '12.345.678K'
// Minúsculas
format('12345678K', { uppercase: false }) // '12.345.678-k'Elimina espacios y ceros a la izquierda por defecto.
import { clean } from 'rut-cl'
clean('00012.345.678-5') // '123456785'Opciones de limpieza:
// Modo estricto (por defecto): Remueve todo excepto números y 'K'
clean('12*345*678-K') // '12345678K'
// Modo tolerante: Solo remueve puntos, comas y guiones
clean('12.345.678-K', { strict: false }) // '12345678K'import { getVerifier } from 'rut-cl'
getVerifier('12345678') // '5'
getVerifier('7618285') // 'K'import { parse } from 'rut-cl'
const res = parse('12.345.678-5')
/*
{
raw: '12.345.678-5',
clean: '123456785',
digits: '12345678',
verifier: '5',
expectedVerifier: '5',
isValid: true
}
*/Compara dos RUTs ignorando formato y mayúsculas.
import { compare } from 'rut-cl'
compare('12.345.678-5', '123456785') // true
compare('7618285-K', '7618285-k') // truevalidate(rut: string): booleanformat(rut: string, options?: FormatOptions): stringclean(rut: string, options?: CleanOptions): stringparse(rut: string): RutParsedcompare(rut1: string, rut2: string, options?: CleanOptions): booleangetVerifier(rut: string): string | null
MIT
