Polish validators

Simple set of validators to validate polish data. Useful in any type of online forms.

Browser and NodeJS support

Library currently supports all the browsers that have > 5% of market share and current LTS versions of NodeJS.

The library code is minified. For the original code, please refer to the GitHub repo.

Library methods are exposed both as classic module.exports and ES6 exports.

Adding to a project

To use library, install it with npm or yarn:

• npm i --save validators-pl
• yarn add validators-pl

Standard module imports

For the standard environment, use require or amd:

const validators = require('validators-pl');
const isValidPesel = validators.isValidPesel(89101012345);

ES6 imports

Using ES6 imports, you can include only the part of library that you need (which is useful for tree shaking and minifying, supported by tools like Webpack):

import {isValidPesel} from 'validators-pl';
const isValidPesel = isValidPesel(89101012345);

Available validators

Provided validators are related only to polish ID data.

| Method name | Parameters | Description | |----------------------|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| | isComplexPassword | String password | Checks the password complexity. Follows simple regEx rules: one digit, one lowercase, one uppercase letter and one special character from the list: $@!%*?& | | isName | String name | Checks if the provided name contains only polish alphabet letters and is a valid polish name | | isLocationNumber | String number | Checks if the passed number is a valid location number (e.g. apartment, street number) | | isPostalCode | String postCode | Checks if provided string is a valid Polish postal code | | isCompliantWithPesel | String/Date date, String pesel | Checks if the provided date matches given PESEL (does not check PESEL validity!!! - check the next method) | | isValidPesel | String pesel | Checks if the given PESEL is a valid PESEL number | | isValidIdNo | String idNo | Checks if the given string is a valid identification number | | isValidPassportNo | String passportNo | Checks if the provided number is a valid passport number | | isValidNip | String nip | Checks if the provided number is a valid NIP |

Testing

Tests can be run by running npm test from the library directory.