data-validator v2

Javascript module that can be very efficiently and conveniently used with forms validation.
Can be used either in html file script tags or as a node.js module

Install

npm i install validator-v2

Usage Example

const Validator = require('validator-v2')
const songValidation = new Validator({
    id: {
        required: true,
        type: Number,
        onError: {
            required: "ID is necessary",
            type: "ID is not a number"
        }
    },
    title: {
        required: true,
        type: String,
        minLen: 4,
        maxLen: 25,
        regexMatch: /^[a-zA-Z\s]+$/,
        onError: {
            any: "Title must be of 4-25 chars and contain only english letters"
        }
    },
    uploaderUsername: {
        type: String,
        minLen: 4,
        maxLen: 20,
        regexMatch: /^[a-zA-Z_]+/,
        onError: {
            any: "Username must be of 4-20 chars",
            regexMatch: "Username must contain only english letters and underscore"
        }
    },
    duration: {
        required: true,
        type: String,
        regexMatch: /^(\d+):(\d+)$/,
        onError: {
            regexMatch: "Duration must be of m:s structure. example: 4:25"
        }
    }
})
songValidation.check({id: "string id", title: "One Day", duration: "3:35"})
    .then(() => {
        console.log("Song is valid")
    })
    .catch(err => {
        console.log(err.msg)
    })

Options

• required: boolean (default is false)
• minLen: number
• maxLen: number
• length: number(exact length) or array[min, max]
• validate: function (view below)
• type: string (Number, String, etc.)
• regexMatch: regex (on unmatch is invalid)
• regexFail: regex (on match is invalid)
• onError: object (view below)
• object: another validator-v2 instance
• each: another validator-v2 instance

object

let personValidation = new Validator({
    name: {
        required: true,
        type: String
    },
    contact: {
        required: true,
        object: new Validator({
            tel: {
                required: false,
                regexMatch: /^\d+$/,
                onError: "Only numbers are allowed in 'tel' field. Remove last 'E' to make it work."
            },
            email: {
                required: true,
                email: true
            },
            address: {
                required: false,
                type: String
            }
        })
    }
 })

each

let authorValidation = new Validator({
    name: {
        required: true,
        type: String
    },
    books: {
        each: new Validator({
            title: {
                required: true,
                type: String
            },
            pagesAmount: {
                required: true,
                type: Number
            }
        })
    }
 })

onError

An object that decides which message to return on rejection. Every failed field may have its own message.
** 'any' property is the default error message (for all cases).
** not more then one (option) message will be returned for a field

validate

Use:

validate: (value, cb) => { ... cb(boolean) }

Parameters

value: The value which was inserted in the check method
cb: The function to invoke when a result whether the validation has succeeded or not was concluded

Details:

Best used for:

1. Async validations (such as database querying, etc.)
2. Customized validations

Example:

    validate: (value, cb) => {
        setTimeout(() => { 
            cb(value > 5)
        }, 1000
    });