Permite validar, limpiar y formatear RUT chilenos en Javascript
npm install @ftapiat/js-rut-utilsRutModel
Utils
RutModel o directamente llamar las funciones de la
utils.
number Número del RUT, requerido en el constructor.
dv Dígito verificador, requerido en el constructor.
formatted RUT formateado.
cleaned RUT sin puntos ni guión.
RutModel es definiendo sus número y DV:
js
import {RutModel} from "@ftapia/js-rut-utils";
const rut = new RutModel(19101178, '3');
`
- Sin embargo, no siempre se tiene esa información. Por lo que también puedes crear RUT de la siguiente forma:
`js
import {RutModel} from "@ftapia/js-rut-utils";
// 1. Aleatorio:
const rutAleatorio = RutModel.random();
// 2. Desde el número del RUT. Esto generará automáticamente su DV:
const rutDesdeNumero = RutModel.fromNumber(19101178);
// 3. Desde el RUT como String. Esto limpiará el RUT y lo asignará
// automáticamente al modelo:
const rutDesdeString1 = RutModel.fromString('10.407.355-7'); // ✔ Funciona con puntos y guión.
const rutDesdeString2 = RutModel.fromString('10407355-7'); // ✔ Funciona sin puntos y con guión.
const rutDesdeString3 = RutModel.fromString('104073557'); // ✔ Funciona sin puntos ni guión.
`
#### RUT erróneos
Si se crea un RUT con datos erróneos, se lanzará el error RutIsMalformedError.
El RUT puede ser erróneo si:
- El dígito verificador es inválido.
`js
import {RutModel} from "@ftapia/js-rut-utils";
// ❌ Esto daría error
new RutModel(19101178, '5');
// ✔ Esto no
new RutModel(19101178, '3');
`
- El número es menor a 1 millón.
`js
import {RutModel} from "@ftapia/js-rut-utils";
// ❌ Esto daría error
new RutModel(111111, '6');
// ✔ Esto no
new RutModel(1111111, '4');
`
- El número no puede ser un RUT falso con todos sus caracteres repetidos, como 11.111.111-1, 22.222.222-2, etc.
`js
import {RutModel} from "@ftapia/js-rut-utils";
// ❌ Esto daría error
new RutModel(44444444, '4');
// ✔ Esto no
new RutModel(19101178, '3');
`
$3
Todas las características de RutModel se subdividieron en varias funciones en la carpeta utils:
#### Limpiar RUT
`js
import {cleanRut} from "@ftapia/js-rut-utils";
// Limpia el RUT de puntos y guiones.
const rut = cleanRut('19.101.178-3'); // '191011783'
`
#### Formatear RUT
`js
import {formatRut} from "@ftapia/js-rut-utils";
// Agrega puntos y guión al RUT
const rut = formatRut('191011783'); // '19.101.178-3'
`
#### Generar RUT aleatorio
`js
import {generateRut} from "@ftapia/js-rut-utils";
const rut = generateRut(); // Generará un RUT con DV, SIN puntos ni guión.
const rut = generateRut(true); // Generará un RUT con DV, CON puntos y guión.
`
#### Generar DV a partir del número del RUT
`js
import {generateDV} from "@ftapia/js-rut-utils";
const dv = generateDV(19101178); // '3'
`
#### Validación - Regex que comprueba que el RUT tenga puntos y guion y el largo de un RUT
`js
import {rutForcedDotsAndDashRegex} from "@ftapia/js-rut-utils";
rutForcedDotsAndDashRegex.test('19.101.178-3'); // ✔ true
rutForcedDotsAndDashRegex.test('191011783'); // ❌ false
rutForcedDotsAndDashRegex.test('19101178-3'); // ❌ false
rutForcedDotsAndDashRegex.test('abcde'); // ❌ false
`
#### Validación - Regex que comprueba que el RUT tenga el largo de un RUT, independientemente de si tiene puntos y guiones
`js
import {rutOptionalDotsAndDashRegex} from "@ftapia/js-rut-utils";
rutOptionalDotsAndDashRegex.test('19.101.178-3'); // ✔ true
rutOptionalDotsAndDashRegex.test('191011783'); // ✔ true
rutOptionalDotsAndDashRegex.test('19101178-3'); // ✔ true
rutOptionalDotsAndDashRegex.test('abcde'); // ❌ false
`
#### Validación - RUT es mayor o igual a 1 millón
`js
import {isRutNumberOver1Million} from "@ftapia/js-rut-utils";
isRutNumberOver1Million(1000000); // ✔ true
isRutNumberOver1Million(11000000); // ✔ true
isRutNumberOver1Million(999999); // ❌ false
`
#### Validación - RUT tiene formato correcto, sobre 1 millón y su DV es válido
`js
import {isRutValid} from "@ftapia/js-rut-utils";
isRutValid('10407355-7'); // ✔ true : Sin puntos con guión y DV válido.
isRutValid('19.982-6'); // ❌ false : Número menor a 1 millón.
isRutValid('44.444.444-4'); // ❌ false : Número repetido.
`
#### Validación - DV corresponde al calculado por el módulo 11
`js
import {isRutValidInModule11} from "@ftapia/js-rut-utils";
isRutValidInModule11(19101178, '3'); // ✔ true
isRutValidInModule11(19101178, '4'); // ❌ false
`
Instalación
`bash
npm install --save @ftapiat/js-rut-utils
`
Testing
`bash
npm install
npm test
``