formng

Express form new generation validator

npm install formng
8 downloads in the last day
8 downloads in the last week
16 downloads in the last month

Express Form New Generation

UNDER HARD DEVELOPMENT, NOT PRODUCTION READY

It need tests. I can't say that it's stable

What filters/validators are available?

I'm not dividing on filters and validators...for me it's called rules If rule modifies variable content it starts from to, remove, parse or something else as we say in everyday life If rules validating variable contents it starts from is At now this rules are available:

    call - { call: { func: function(field. fieldName, opts){} }}
    required
    parseJson
    removeIfEmpty - Will remove [], {}, '', null, false, undefined ...
    isString
    nl2br
    match - { match: { regexp: /exp/, message: '' } }
    trim
    isArray
    toFloat
    isObject
    entityDecode
    entityEncode
    toInt
    toArray
    $childs
    $each

How to define the rules?

It's simple. I guess example will say more than i can:

    var formng = require('formng')
      , body = {
          id: '15',
          foo: ' <script> alert(1); </script><h1>some &nbsp; HTML</h1>     ',
          bar: '  ',
          baz: 'abc'
        }

    var form = formng({
      id: [ 'removeIfEmpty', parseInt ], // Here we call some rule and builtin js function `parseInt`
      foo: [ 'trim', 'required', 'entityEncode' ],
      bar: [ 'trim', 'required' ], // Will call next(new Error()) because `bar` was trimmed and empty now
      baz: [ function(field, fieldName, opts){
        return field + 'def';
      }, /^abcdef$/ ], // Here i have defined custom function, that concats `baz` value with 'def' string, after tests whether the `baz` matching /^abcdef$/ regexp 

      // Rules with options
      faz: {
        match: { reqexp: /^a.+/, message: '%s not matching regexp' }
      }

      // We can also validate nested json, but this technics not optimized yet...if you interested in that - look into the code or feel free to contact with me

    });


    app.get('/', function(req, res, next){
      // Here we will set `req.body`
      req.body = body;
      next();
    }, form, function(req, res, next){
      res.send('Passed') // You will not see this without modifying `body`...play with it :)
    });

Custom functions

It can be any function that expects value as first arg and returns value Or function like this:

    function(fieldValue, fieldName, optsPassed) {
      return 'some string to set new value'
      return false // to throw an error
      return null // to remove field from req.body
      // or return nothing(undefined) to save the value
    }

Errors:

It tryes to find .message attr in rule attributes(if presented, if not - default will be used)o If using custom validation function...we can just add message to opts object All errors passing to the next(new Error('message')) Formng will finish checking and redirect user to error route on first error found.

Rules return values and meanings:

return false - validation error. return undefined - do not modify the field, that rule was validation rule< not filter return null - delete field from body

Everything excepts all above will modify field value If false|undefined|null value is needed this function will help you(just pass it as a rule):

      function(field, fieldName, opts){
          this.set(fieldName, null/* false or undefined */)
      }

And...oh...you can manualy write rules. See node_modules/formng/rules

npm loves you