checkval v0.1.1

checkval

The most versatile validator for Node JS and web browsers.

Usage

Server-side

var checkval = require('checkval');

Client-side

<script type="text/javascript" src="checkval.min.js"></script>

Sintaxis

Returning boolean:

if ( !checkval('email@example.com').email().check() ) {
	console.error('invalid data');
}

Returning boolean (multiple validations):

if ( !checkval().
		add('456457', 'id').numeric().len(5, 10).
		add('email@example.com').email().check() ) {

	console.error('invalid data');
}

Throwing an error:

try {
	
	checkval().
	  add('456457', 'id').numeric().len(5, 10).
	  add('email@example.com', 'email').email().
	throw();

} catch (err) {
	console.error(err);
}

Getting all errors:

var errors = checkval().
	add('456457', 'id').numeric().len(5, 10).
	add('email@example.com').email().
	errors();

while ( errors.length > 0 ) {
	console.error(errors.pop());
}

Validators

• alpha() : check if the value contains only letters (a-zA-Z).
• alphanumeric() : check if the value contains only letters and numbers (a-zA-Z0-9).
• email() : check if the value is an email.
• len(min, max) : check if the value's length falls in a range.
• notNull() : check if the value is not null.
• null() : check if the value is null.
• integer() : check if the value is an integer (e.g. 345, -81)
• positiveInt() : check if the value is a positive integer (e.g. 345)
• numeric() : check if the string contains only a valid integer or decimal number (0-9).
• date() : check if the string is a valid date.
• regex(regex, msg) : returns true if the value matches the comparison. e.g.: checkval().add("test").regex(/^test$/).check()
• uuid() : check if the value is a UUID (version 3, 4 or 5).
• bool() : check if the value is a boolean (strict)
• array() : check if the value is in a valid array.
• inArray(values) : check if the value is in a array of allowed values.

Running tests

To run the test suite, first invoke the following command within the project folder, installing the development dependencies:

$ npm install

Then run the tests:

$ npm test

License (MIT)