validjs v1.0.0

Vjs

A Basic validator implementation, which checks if a value is valid and as expected and executes the corresponding callback function as needed, and at the end of the check if a callback for the whole test exists it will execute the corresponding callback.

Live example

Structure: validate.js exports two modules:

• Validate <- for validation purposes
• Checks <- the isBlah() utilities are here (for example isArray is in here).

Usage and Explanation & consedirations:

• if the the check function fails
  • if there is no callback or string defined -> the return value will be false
  • if there is a callback or string defined -> the return value will be the string or the return of the function
• if the the check function passes
  • if there is no callback or string defined -> the return value will be true
  • if there is a callback or string defined -> the return value will be the string or the return of the function
• the return value of validate is an array.
• If you have your own check functions there is no need to import the check functions.

Import the Vjs validate method and the check utils.

var v=require('../validate.js').Validate;
var c=require('../validate.js').Check;

The v object is instantiated when imported and now it can be used to call the validate method accompanied with the set method to set the validations.

result=v.validate([v.validate(c.isString('hello'), onFail, onPass , [v.validate(c.isString(1984), onFail, onPass , outerFail,outerPass);

onFail and onPass can be a string or a function. On each of the corresponding states either the string is returned or a return value from a function is retuned. After the validation finishes if there is a fail the outerFail will execute or if all is passed the outerPass is executed.

var result=v.validate([
                        c.isString('hello'),
	                    'failed is a string',
    	                'passed is a string')
		  ]);
		  
console.log(result[0]) //  passed is a string
	
var result=v.validate([
                        c.isString('hello'),
	                    'failed is a string',
    	                'passed is a string')
		  ],
		  [
                        c.isString(33),
	                    'failed is a string',
    	                'passed is a string')
		  ]
		  );
		  
console.log(result[0]) //  passed is a string
console.log(result[1]) //  failed is a string
	

or in the above examples instead of the strings a function may be used as

var myOnFail=function(){
             return 'failed is a string'
	}
var myOnPass=function(){
             return 'passed is a string'
	}
	
	
var result=v.validate([
                        c.isString('hello'),
	                    myOnFail,
    	                myOnPass)
		  ],
		  [
                        c.isString(33),
	                    myOnFail,
    	                myOnPass)
		  ]
		  );
		  
console.log(result[0]) //  passed is a string
console.log(result[1]) //  failed is a string

Tests:

To run the test navigate to the test directory and execute mocha.

mocha

Links:

• GitHub home page
• GitHub page
• jsFiddle