validate-polish

Utility library for validation of PESEL, NIP, REGON, identity card etc. Aimed mostly at Polish environment. [Polish] Walidacja numerów pesel, nip, regon, dowodu osobistego.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
validate-polish
2.1.40a year ago8 years agoMinified + gzip package size for validate-polish in KB

Readme

<h1>validate-polish</h1>
<div>Utility library for validation of PESEL, NIP, REGON, identity card etc. Aimed mostly at Polish enviroment. [Polish] Walidacja numerów pesel, nip, regon, dowodu osobistego.</div>

Table of contents

  1. Getting Started

  1. Usage

  1. Features

Getting Started

npm i validate-polish

Usage

General

import { validatePolish } from 'validate-polish';

if (!validatePolish.pesel(`92060512181`)) {
    throw new Error(`Invalid pesel.`);
}

if (!validatePolish.nip('115667734')) {
    throw new Error(`Invalid nip.`);
}

if (!validatePolish.regon(`1251677`)) {
    throw new Error(`Invalid regon.`);
}

if (!validatePolish.identityCard(`14124142`)) {
    throw new Error(`Invalid identity card.`);
}

Browser

In browser validate-polish package is wrapped twice validatePolish.validatePolish.
<script src="https://cdn.jsdelivr.net/npm/validate-polish@latest/dist/index.browser.js"></script>
<script>
    console.log(validatePolish.validatePolish);
</script>

Features

  • CDN - available via cdn (https://cdn.jsdelivr.net/npm/validate-polish@latest/dist/index.browser.js)
  • Cross-platform - works in Node.js, browser and with bundlers such as webpack
  • Fast, lightweight, 0 dependencies - no dependencies ensure there are no security breaches from other packages
  • Maintained - if you need additional functionality feel free to create PR or an Issue
  • Strongly typed - library written fully in TypeScript
  • Supports PESEL, REGON (9 and 14), NIP, IDENTITY CARD - also validates day and month correctness including century encoded in month.
  • Tested - has tests on dozens of valid and invalid chunks of data to make sure validations are performed flawlessly