sm-form-validation

A simple JS form Validation, for projects using Node.

Installation

Install with NPM.

npm install sm-form-validation

Simple Usage

const { validate, required, email } = require('sm-form-validation') // import the validate function and the validations

validate( //Call validate function
     [
         {name: [ required('Fill the name') ]}, // you can pass a custom error message
         {email: [ email() ]}, // or just don't pass anything (Default return in English)
     ]
 )
     .then(() => { // success promise don't return any value
         console.log('success')
     })
     .catch((err) => { // error promise return an array with all error occurrences
         console.log(err)//array
     })

The Validation Function

It receives an array of objects, that contains the value to validate and a validation array.
Then return a Promise that return empty when success or a array when has an error

validate( [ { value : [ validation array ] } ] )
  .then(()=>{})
  .catch((err)=>{ console.log(err)})

The Error Return

When the validation gets error, it return an Array with all the occurrences.
This code:

validate(
    [
        {'': [required()]}, // empty value, validation Required()
    ]
)
    .then(() => {
        console.log('success')
    })
    .catch(err => {
        console.log(err)
    })

Will return this Array:

[
  {
    value: '', // Value to validate
    index: 0,  // index on value array
    validation: [Function: validateRequired], // Validation Type
    status: 'The field is required' // The default error message
  }
]

Custom Error Messages

For each validation, you can pass a custom error message as a param in the function.

validate(
  [
    {'email@email': [ email('PUT AN VALID EMAIL PLS') ]}, // to single validations, just pass an string as a parameter
    {5 : [ minmax(4,10,['Minimum value not reached', 'Maximum value reached']) } // to minmax validation, you have to pass the messages on an array
  ]
 )

Condition

For each object value, you can pass a condition to set if the validation gonna run or not as a second Key, called condition.
As a value of condition you have to pass an object with the values that you want to compare on the respectively order.

let usingEmail = true // this variable gonna be the trigger to validate or not the email field
validate(
    [
        {'contatosmolski@gmail': [email('Wrong email')],condition: {[usingEmail]: true}}, // the sintax to condition is ' condition:{ firstValue : secondValue } '
    ]
)

In the code below we have two examples:
The email gonna validate and throw an error:
The name will not start validation:

let usingEmail = true // this variable gonna be the trigger to validate or not the email field
let usingName = false // this variable gonna be the trigger to validate or not the name field
validate(
    [
        {'contatosmolski@gmail': [email('Wrong email')],condition: {[usingEmail]: true}}, // passing a wrong email
        {'': [required('The name field is required')], condition: {[usingName]: true}} // passing a empty name (normaly it gonna return an error)
    ]
)
    .then(() => {
        console.log('success')
    })
    .catch(err => {
        console.log(err)
    })

The Return

  [
    {
      value: 'contatosmolski@gmail', // it only validates the email
      index: 0,
      validation: [Function: validateEmail],
      status: 'Wrong email'
    }
  ]

Validations

Name	Sintax	Description
Required	required( ' Custom Message ' )	Validate the length of the value or if value is undefined or null
Custom	custom( customValue, ' Custom Message ' )	Validate a custom passed value
Email	email( ' Custom Message ' )	validate a string by an email valid Regex
Minmax	minmax( minVal ,maxVal ,[ 'Min Custom Message', 'max Custom Message' ] )	Validate a value by the min and the max value passed
Cpf	cpf( 'Custom Message' )	Validate a document by a valid Regex
Cnpj	cnpj('Custom Message' )	Validate a document by a valid Regex

smolskig / sm-form-validation