Lightweight and Powerful Data Validation Library – Iodine.js

Preview:

Description:

Iodine is a tiny validation JavaScript library that lets you easily validate data in the browser with a simple API and no dependencies. It supports chainable validation rules so you can verify data meets multiple criteria.

Out of the box, it includes rules for common needs like checking for valid emails, dates, numbers, and more. You can also create custom rules.

How to use it:

1. Install and import the Iodine.

# NPM
$ npm i @caneara/iodine

// browser
<script src="/path/to/dist/iodine.min.umd.js" defer></script>
// ES Module
import Iodine from '@caneara/iodine';

2. Initiate a new instance of the Iodine:

const myValidator = new Iodine();

3. Here are the available validation rules in Iodine. Note that all of Iodine’s rules start with assert.

// true
myValidator.assertInteger(7); 
// false
myValidator.assertInteger('cssscript.com');

4. Apply multiple rules to your data.

// true
myValidator.assertInteger(7, ['required', 'integer']);
// false
myValidator.assertInteger('cssscript.com', ['required', 'integer']);

// multiple items
const items = {
      name: CSSScript,
      email: '[email protected]',
      password: 'abcdefgh',
};
const rules = {
      name: ['required', 'string'],
      email: ['required', 'email'],
      password: ['required'],
};
myValidator.assert(items, rules);

// additional parameters
myValidator.assert(7, ['required', 'integer', 'min:5']);

// Optional values
myValidator.assert(7, ['optional', 'integer']);

5. Replace default error messages:

// Custom Errors
myValidator.setErrorMessages({ 
  same : `[FIELD] must be '[PARAM]'` 
});
// Single Errors
myValidator.setErrorMessage('passwordConfirmation', 'Does not match password');
// Custom Errors by Field
myValidator.assert(value, ['required'], { 'required' : 'The "Label" must be present.' });

6. Add custom rules using the rule function:

// Simple
myValidator.rule('newRule', (value) => ());
// With parameters
myValidator.rule('newRule', (value, param) => ());