Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jlobos/rut.js
:chile: Sencilla y pequeña librería para validar y dar formato al RUT
https://github.com/jlobos/rut.js
browser chile cl limpiar node rut validar
Last synced: about 1 month ago
JSON representation
:chile: Sencilla y pequeña librería para validar y dar formato al RUT
- Host: GitHub
- URL: https://github.com/jlobos/rut.js
- Owner: jlobos
- License: mit
- Created: 2016-10-28T20:05:07.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-06-25T19:31:48.000Z (3 months ago)
- Last Synced: 2024-07-26T07:08:18.555Z (about 1 month ago)
- Topics: browser, chile, cl, limpiar, node, rut, validar
- Language: JavaScript
- Homepage: https://npmjs.com/rut.js
- Size: 131 KB
- Stars: 155
- Watchers: 6
- Forks: 20
- Open Issues: 3
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# rut.js 🇨🇱
Sencilla y pequeña libreria para validar y dar formato al RUT. Funciona en Node.js y Navegadores (Webpack, Browserify, etc.)
> Utilizada en producción para manejar mas de 13 millones de chilenos en [~Rutify – Rutificador~](https://rutify.cl/)
```js
// AMD
const { validate, clean, format, getCheckDigit } = require('rut.js')
// ES2015 Modules
import { validate, clean, format, getCheckDigit } from 'rut.js'
// true
validate('18.972.631-7')
validate('18972631-7')
validate('189726317')
validate('9.068.826-k')
validate('9068826-k')
validate('9068826k')
// false
validate('18.972.631-0')
validate('18,972,631-7')
validate('18*972*631-7')
validate('18-972-631-7')
validate('error18.972.631-7')
validate('9068826-1')
validate('')
validate(189726317)
validate('0')
validate(0)
/**
* Limpiar un RUT
*/
clean('189726317') // '189726317'
clean('18.972.631-7') // '189726317'
clean('12.345.678-k') // '12345678K'
clean('12*345*678*k') // '12345678K'
clean('000189726317') // '189726317'
/**
* Dar formato a un RUT
*/
format('18.972.631-7') // '18.972.631-7'
format('189726317') // '18.972.631-7'
format('18*972*631*7') // '18.972.631-7'
format('9068826-k') // '9.068.826-K'
// Dots es true por default
format('18.972.631-7', { dots: false }) // '18972631-7'
format('189726317', { dots: false }) // '18972631-7'
format('18*972*631*7', { dots: false }) // '18972631-7'
format('9068826-k', { dots: false }) // '9068826-K'
/**
* Obtener el dígito verificador
*/
getCheckDigit('18.972.631') // '7'
getCheckDigit('9068826') // 'K'
```
## Instalación
```bash
npm install --save rut.js
yarn add rut.js
```
## Testing
```bash
npm install
npm test
```