Skip to content

Biblioteca para validar, gerar e formatar CPF, CNPJ e outras identificações.

License

Notifications You must be signed in to change notification settings

ArturMiguel/dochelper

Repository files navigation

dochelper

Biblioteca para validar, gerar e formatar CPF, CNPJ e outras identificações.

npm version npm downloads license

Features

  • CPF - Validação, geração e formatação de CPF.
  • CNPJ - Validação, geração e formatação de CNPJ.
  • PLACA - Validação, geração e formatação de placas veículares brasileiras (ABC-1234).

Possui definições de tipo para o TypeScript.

Instalação

npm install dochelper

Utilização

import * as dochelper from "dochelper";
// const dochelper = require("dochelper"); // CommonJS

console.log(dochelper.CPF.validate('111.444.777-35')); 
// true
console.log(dochelper.CPF.generate()); 
// e.g. 67152064229
console.log(dochelper.CPF.format('11144477735')); 
// 111.444.777-35
console.log(dochelper.CPF.unformat('111.444.777-35')); 
// 11144477735

Módulos

CPF

Função Exemplo Saída
validate dochelper.CPF.validate(str: string) Retorna se o CPF é válido. A entrada pode ser com ou sem máscara.
generate dochelper.CPF.generate(formatted?: boolean) Retorna um CPF válido gerado randomicamente.
format dochelper.CPF.format(str: boolean) Retorna a entrada formatada como CPF.
unformat dochelper.CPF.unformat(str: string) Retorna a entrada sem a formatação de CPF.

"format" e "unformat" retornam nulo se a entrada estiver fora do padrão de um CPF com/sem máscara.

CNPJ

Função Exemplo Saída
validate dochelper.CNPJ.validate(str: string) Retorna se o CNPJ é válido. A entrada pode ser com ou sem máscara.
generate dochelper.CNPJ.generate(formatted?: boolean) Retorna um CNPJ válido gerado randomicamente.
format dochelper.CNPJ.format(str: boolean) Retorna a entrada formatada como CNPJ.
unformat dochelper.CNPJ.unformat(str: string) Retorna a entrada sem a formatação de CNPJ.

"format" e "unformat" retornam nulo se a entrada estiver fora do padrão de um CNPJ com/sem máscara.

PLACA

Modelo brasileiro (ABC-1234)

Função Exemplo Saída
validate dochelper.PLACA.br.validate(str: string) Retorna se a placa está no formato válido. A entrada pode ser com ou sem máscara.
generate dochelper.PLACA.br.generate(formatted?: boolean) Retorna uma placa válida gerada randomicamente.
format dochelper.PLACA.br.format(str: boolean) Retorna a entrada formatada no modelo de placa ABC-1234.
unformat dochelper.PLACA.br.unformat(str: string) Retorna a entrada sem a formatação de placa.

"format" e "unformat" retornam nulo se a entrada estiver fora do padrão de placa veicular ABC-1234.

Licença

O código fonte está disponibilizado conforme a licença MIT.