2valid

JavaScript simple data validator

v3.1.1

Installation

npm install --save 2valid

Usage ( simple example )

Check for integer

var v = require('2valid');
// valid? true/false
console.log( v.valid('integer', 111) ); // true
console.log( v.valid('integer', 'aaa') ); // false
 
// check, what was wrong
console.log( v.check('integer', 111) ); // null
console.log( v.check('integer', 'aaa') ); // { notMatched: 'integer' }

Usage ( node.js password validator )

Check for password. Minimum 4 chars, at least one caps and one small letter, digit and special

var v = require('2valid');
console.log( v.valid('password', '!A1e') ); // true
console.log( v.valid('password', 'As1eRR') ); // false
console.log( v.check('password', 'As1eRR') ); // { notMatched: 'password' }

Get examples

var v = require('2valid');
var example = v.getExample('email');
console.log( example ); // news@site.com
console.log( v.valid('email', example) ); // true (email is valid)
console.log( v.check('email', example) ); // null (check why email is not valid)

Available types

type	description
string	string
integer	integer number
float	float number
boolean	boolean
array	array type
date	date methods
email	simple e-mail
password	password, minimum 4 chars, at least one caps and one small letter, digit and special
md5	MD5 string
uuid	UUID string
any	any of elements of array

Results

If check passed, then result is null.

Otherwise check result is object with these keys:

notMatched [object] - which key does not match which type
notRequired [array of string] - list of keys are not in model
notFound [array of string] - which keys in model are not found in checked object
text [string] - simple description of all errors

For example:

{ notMatched: { '.id': 'integer' },
  text: 'Field .id not matched with type integer. Field .secondName not required. Field .name not found',
  notRequired: [ '.secondName' ],
  notFound: [ '.name' ] }

Usage

Simple async mode

Check if integer

var v = require('2valid');
 
v.check( 'integer', 111, function(err) {
  console.log(err); //null
});
 
v.check( 'integer', '61cecfb4-da43-4b65-aaa0-f1c3be81ec53', function(err) {
  console.log(err); // { notMatched: 'integer' }
});

With simple model

Check if valid to simple object with integer id and string name

var vm = require('./index');
 
var userModel = {
  id: {type: 'integer'},
  name: {type: 'string', required: true}
};
 
vm.check( userModel,
  { id: 123, secondName: 'Max Validator' },
  function(err) {
    console.log(err); // null
  }
);

Full error stack

Validation failed with all types of errors

var vm = require('./index');
 
var userModel = {
  id: {type: 'integer'},
  name: {type: 'string', required: true}
};
 
vm.check( userModel,
  { id: 'Max', secondName: 'Validator' },
  function(err) {
    console.log(err);
  }
);

Result

{ notMatched: { '.id': 'integer' },
  text: 'Field .id not matched with type integer. Field .secondName not required. Field .name not found',
  notRequired: [ '.secondName' ],
  notFound: [ '.name' ] }

With register model

Rregister user model to check validation by model name

var v = require('2valid');
 
// register model 'user' to check integer 'id' and string 'name'
v.registerModel('user', {
  id: {type: 'integer'},
  name: {type: 'string'}
});
 
// object to check
var userObject = {id: 123, name: 'Alex Validates'}
 
// check if object is valid sync
var valid = v.check('user', userObject);
console.log(valid.text || 'object is valid');
 
// check if object is valid with callback
v.check('user', userObject, function(err) {
  console.log(err || 'object is valid');
});

Result

object is valid

Nested object validator

Validate name.first and name.second

var v = require('2valid');
 
// property 'name' of 'user' model must have 'first' (required) and 'last' keys.
v.registerModel('user', {
    name: {
        first : { type: 'string', required: true },
        last  : { type: 'string' },
    }
});
 
// {}
console.log(v.check('user', {name: {first: 'Alex', last: 'Validator'}}));
console.log(v.check('user', {name: {first: 'Marry'}}));
 
// { notFound: [ '.id', '.name.first' ],
//   text: 'Field .id not found in registered model. Field .name.first not found in registered model' }
console.log(v.check('user', {id: 123}));
 
// { notFound: [ '.name.first' ], text: 'Field .name.first not found in registered model' }
console.log(v.check('user', {name: {last: 'Alex'}}));

Regex validator

Only 'cyan', 'magenta', 'yellow' or 'key' can passed in cmyk model to validate

var v = require('2valid');
 
// property 'name' of 'cmyk' model must be 'cyan', 'magenta', 'yellow' or 'key' value
v.registerModel('cmyk', {name: { type: 'string', match : /^cyan|magenta|yellow|key$/i }});
 
// {}
console.log(v.check('cmyk', {name: 'Magenta'}));
 
// { notMatched: { '.name': 'string' }, text: 'Field .name not matched with type string' }
console.log(v.check('cmyk', {name: 'black'}));
console.log(v.check('cmyk', {name: 123}));

Any validator

Only 'cyan', 'magenta', 'yellow' or 'key' can passed in cmyk model to validate

var v = require('2valid');
 
console.log(v.check('any', 'yellow', {one: ['cyan', 'magenta', 'yellow', 'key']})); //passed
console.log(v.check('any', 123, {one: ['cyan', 'magenta', 'yellow', 'key']})); //{ notMatched: 'any' }

Required keys validator

Check if field is required

var v = require('2valid');
 
// property “id” required and must be uuid
v.registerModel('user', {id: { type: 'uuid', required: true }});
 
// {}
console.log(v.check('user', {id: '61cecfb4-da43-4b65-aaa0-f1c3be81ec53'}));
 
// { notMatched: { '.id': 'uuid' }, text: 'Field .id not matched with type uuid' }
console.log(v.check('user', {id: 123}));
 
// { notFound: [ '.name', '.id' ],
//   text: 'Field .name not found in registered model. Field .id not found in registered model' }
console.log(v.check('user', {name: 'Alex'}));

Length checking validator

Checking for fixed length of the string

var v = require('2valid');
 
// property “name” must be exacly 2 chars length
v.registerModel('ISO 3166-2', {name: { type: 'string', min: 2, max: 2 }});
 
// {}
console.log(v.check('ISO 3166-2', {name: 'US'}));
 
// { notMatched: { '.name': 'string' }, text: 'Field .name not matched with type string' }
console.log(v.check('ISO 3166-2', {name: 123}));
console.log(v.check('ISO 3166-2', {name: 'USA'}));
console.log(v.check('ISO 3166-2', {name: 'U'}));

Add type

You can add new type to validate in to types.js. 'check' method is required to check new inserted type.

For example, new type 'password'. It type must contains minimum 4 chars: at least one lower and one upper case, digit and special chars. Add code below to types.js in list property:

password : {
    min   : 4,         // string.min Minimum length of the string
    max   : Infinity,  // string.max Maximum length of the string
    check : function( password ){   // check password type and size
        if ( ( typeof string === 'string' || string instanceof String )
                && string.length >= this.min
                && string.length <= this.max
                && string.match(/((?=.*\\d)(?=.*[a-z])(?=.*[A-Z])(?=.*[\W]).+)/)
        )
            return true
        else
            return false;
    }
}

Tests

npm test

Module description

Methods and properties of 2valid

valid( modelName, entity ) - validate model modelName with entity. Return true if validate is ok. Otherwise, return false.
check( modelName, entity [, callback] ) - validate model modelName with entity. Return empty object if validate is ok. As callback, return error as first argument.
registerModel( modelName, modelObject ) - register model modelName with modelObject to check
registeredModels - list of registered models
showModelsFull() - show full information of registered model
dispose() - remove all registered modelNames

Register model

For register model you need to use registerModel method.

v.registerModel( 'user', {
  id:   { type: 'uuid', required: true }, // property “id” must be uuid
  name: { type: 'string', min: 4, max: 128, required: true }, // property “name” must be String and contain 4-128
  password: { type: 'password', max: 128, required: true }, // property “password” must be String and contain 4-128 chars:
});

Validate object

v.check( 'user', { id : '61cecfb4-da33-4b15-aa10-f1c6be81ec53', name : 'Validator', password : 'A1z!' })

Exceptions

Name is undefined

myLibrary.registerModel( 'Name', { id: { type: 'uuid', required: true } } );

Model in 'modelName' is undefined

myLibrary.registerModel( 'modelName', NaN );

Model 'modelName' is already registered

myLibrary.registerModel( 'modelName', { id: { type: 'uuid', min: 1, max: 5, required: true } } );
myLibrary.registerModel( 'modelName', { id: { type: 'name' } } );

No field 'name' in key 'name' in model 'modelName'

myLibrary.consoleTrueOrError ( myLibrary.check( 'modelName', { name  : 'Alex Validates' }) );

No type field exception

myLibrary.registerModel( 'name_exception', { date: { parameter: 'date' } } );

No guid type exception

myLibrary.registerModel( 'name_exception', { id: { type: 'guid' } } );

Release History

0.1.0 Initial release
0.2.0 Fix nested required object error
0.2.2 Update errors handles
0.2.4 Add match ability to string
0.2.10 Split number to integer and float, add password type
0.2.12 Validate md5 hash
0.3.2 Change quotes in messages
0.4.1 Replace result with notFound, notMatched and text keys
2.0.1 Rename project to 2valid
2.2.1 Add boolean and array types
2.2.2 Add examples
3.0.1 Add check function instead of depricateded validate

Created by

Dimitry, 2@ivanoff.org.ua

curl -A cv ivanoff.org.ua

2valid

2valid

JavaScript simple data validator

Installation

Usage ( simple example )

Usage ( node.js password validator )

Available types

Results

Usage

Simple async mode

With simple model

Full error stack

With register model

Nested object validator

Regex validator

Any validator

Required keys validator

Length checking validator

Add type

Tests

Module description

Methods and properties of 2valid

Register model

Validate object

Exceptions

Release History

Created by

Readme

Keywords

Package Sidebar

Install

Repository

Homepage

Weekly Downloads

Version

License

Last publish

Collaborators

2valid

2valid

JavaScript simple data validator

Installation

Usage ( simple example )

Usage ( node.js password validator )

Available types

Results

Usage

Simple async mode

With simple model

Full error stack

With register model

Nested object validator

Regex validator

Any validator

Required keys validator

Length checking validator

Add type

Tests

Module description

Methods and properties of 2valid

Register model

Validate object

Exceptions

Release History

Created by

Readme

Keywords

Package Sidebar

Install

Repository

Homepage

DownloadsWeekly Downloads

Version

License

Last publish

Collaborators

Weekly Downloads