ferds-validator v1.0.4

Ferds Validator

Ferds Validator is a simple validator that is intended for processing data validation in a concise manner. Ferds Validator has several advantages over other packages, such as:

• Use only one variable to perform various validations
• Validation looks more familiar to those of you who are accustomed to using the PHP programming language with the CodeIgniter and Laravel framework

Features

Now, let’s describe the features:

• Check for required data.
• Simple basic validation rules
• Verify that the data is of the correct type, and meets the correct criteria. For example, if a username is submitted it must be validated to contain only permitted characters. It must be of a minimum length, and not exceed a maximum length. Etc.

Installation

$ npm install ferds-validator

Usages

Basic validation usage

Examples of simple use :

var validator = require( 'ferds-validator' );
var rules = [
	{
		"name": "Alpha Only", // field description
		"value": "ABC", // value that will be validated
		"rules": "alpha" // validate alphabet characters only
	},
	{
		"name": "Required Alpha Only",
		"value": "",
		"rules": "required|alpha"
	},
	{ // Return false, because the value must be greater or equal to 30
		"name": "Age",
		"value": 25,
		"rules": "required|numeric|greater_than_equal_to(30)"
	},
	{ // Return False
		"name": "Exact Length",
		"value": "ABCDE92",
		"rules": "required|exact_length(5)|alpha"
	},
	{ // Return False
		"name": "Minimum Length",
		"value": "123123",
		"rules": "required|min_length(2)|numeric"
	},
	{ // Return True
		"name": "Maximum Length",
		"value": "123123",
		"rules": "required|max_length(10)|numeric"
	},
	{ // Return True
		"name": "Maximum Length Or Equal To",
		"value": "AB123",
		"rules": "required|max_length_equal_to(5)|alpha_numeric"
	},
	{ // Return True
		"name": "Birth Date",
		"value": "1993-11-267",
		"rules": "required|date(YYYY-MM-DD)"
	},
}
var run_validator = validator.run( rules ); // Set to variable
console.log( run_validator ); // Raw output

if ( run_validator.status == false ) {
	// your code...
}
else {
	// your code...
}

Raw output :

{
	"status": false,
	"message": "Unfortunately, some error has occured.",
	"error_lists": [
		"The Required Alpha Only field is required. ",
		"The Age field must contain a number greater than or equal to 30. ",
		"The Exact Length field must be exactly 5 characters in length. ",
		"The Exact Length field may only contain alphabetical characters. ",
		"The Birth Date field must contain a valid date with format YYYY-MM-DD. "
	]
}

Simple usage with Express

Examples of simple use with express :

const express = require( 'express' );
const body_parser = require( 'body-parser' );
const app = express();
const validator = require( 'ferds-validator' );

app.use( body_parser.urlencoded( { extended: false } ) );
app.use( body_parser.json() );
app.listen( 5000, () => {
	console.log( 'Tester Package running on port 5000' );
} );
app.post( '/test', ( req, res ) => {
	var rules = [
		{
			"name": "IP Address",
			"value": req.body.ip_address,
			"rules": "ip_address"
		},
		{
			"name": "Regex Match",
			"value": req.body.regex_match,
			"rules": "required|regex_match(/^[a-zA-Z0-9]+$/)"
		},
		{
			"name": "Website URL",
			"value": req.body.website_url,
			"rules": "required|url"
		},
		{
			"name": "Longitude",
			"value": req.body.longitude,
			"rules": "required|longitude"
		},
		{
			"name": "Latitude 1",
			"value": req.body.latitude,
			"rules": "required|latitude"
		},
	];
	var run_validator = validator.run( rules ); // Set to variable

	if ( run_validator.status == false ) {
		// Sample
		res.json( {
			status: false,
			message: "Please check your input.",
			error_lists: run_validator.error_lists // Show error validation lists
		} );
	}
	else {
		// your code if validation is true...
	}
} );

Rule Reference

The following is a list of all the native rules that are available to use:

Author

Ferdinand <ferdshinodas@gmail.com>