prg-validator v0.4.0

Pragonauts Isomorphic Validator

Node.js/Browser validation utility, which allows us to use single validator across multiple endpoints. Uses (npm/validator)https://www.npmjs.com/package/validator rules.

const Validator = require('prg-validator');


class UserValidator extends Validator {

    constructor () {

        super();

        this.CONTEXT_REGISTER_WITH_PASSWORD = 'registerWithPassword';

        this.CONTEXT_CREATE = 'create';

        this.CONTEXT_UPDATE = 'update';

        this.add('email')
            .if([this.CONTEXT_REGISTER_WITH_PASSWORD, this.CONTEXT_CREATE])
                .isRequired('Email is required')
            .endIf()
            .isEmail('The email has to be valid');

        this.add('username')
            .if([this.CONTEXT_CREATE])
                .isRequired('The username is required')
            .endIf()
            .is('isLength', 'The username has to be at least 1 character long.', {
                min: 1
            });

        this.add('password')
            .if([
                this.CONTEXT_REGISTER_WITH_PASSWORD,
                this.CONTEXT_SET_PASSWORD,
                this.CONTEXT_CREATE
            ])
                .isRequired('Password is required')
            .endIf()
            .if(val => val)
                .is('isLength', 'The password has to be at least 7 characters long.', { min: 7 })
            .endIf();
    }

}

const catchAllErrors = false;
const validator = new UserValidator();

validator.validate({ email: 'ab' }, validator.CONTEXT_UPDATE, catchAllErrors)
    .then((validData) => {
        // successful validation, data are filtered
    })
    .catch((e) => {
        // e instanceof ValidationError, or ValidationError[] when catchAllErrors is true
    });

API

Classes

ValidationError

Kind: global class

• ValidationError
  • .message
  • .property
  • .type

validationError.message

Kind: instance property of ValidationError
Properties

validationError.property

Kind: instance property of ValidationError
Properties

validationError.type

Kind: instance property of ValidationError
Properties

Validator

Kind: global class

• Validator
  • new Validator()
  • .add(property) ⇒ Rule
  • .validateProp(property, value, [catchAllErrors], [data]) ⇒ Promise
  • .validate(data, [context], [catchAllErrors]) ⇒ Promise.<object>

new Validator()

Single entity validator. Just extend this class

validator.add(property) ⇒ Rule

Add another property to validate

Kind: instance method of Validator

validator.validateProp(property, value, catchAllErrors, data) ⇒ Promise

Validate single property

Kind: instance method of Validator

validator.validate(data, context, catchAllErrors) ⇒ Promise.<object>

Kind: instance method of Validator

Rule

Kind: global class

• Rule
  • new Rule()
  • new Rule(rules)
  • .is(action, [message], [args]) ⇒ this
  • .to(action, [args]) ⇒ this
  • .if(action) ⇒ this
  • .endIf() ⇒ this
  • .default(value) ⇒ this
  • .contains(string, [message]) ⇒ this
  • .isNumeric([message]) ⇒ this
  • .isEmail([message]) ⇒ this
  • .isUrl([message], [options]) ⇒ this
  • .isRequired([message]) ⇒ this
  • .isRequiredIfPresent([message]) ⇒ this
  • .isFileMime(message, types) ⇒ this
  • .isFileMaxLength(message, types) ⇒ this
  • .toInt([message]) ⇒ this
  • .toBoolean([message]) ⇒ this
  • .toFileData() ⇒ this

new Rule()

Single attribute rule contructor

new Rule(rules)

Creates an instance of Rule.

rule.is(action, message, args) ⇒ this

Add any validator to rule

Kind: instance method of Rule

Example

validator.add('property')
    .is(value => value.match(/xy/))

rule.to(action, args) ⇒ this

Adds sanitizer (filter) which converts value to different type

Kind: instance method of Rule

Example

validator.add('property')
    .to(value => parseInt(value, 10));

rule.if(action) ⇒ this

Adds confition. It can filter validators by context or with custom function

Kind: instance method of Rule

Example

validator.add('property')
    .if((value, data, context) => data.otherProperty)
        .isRequire('Should be filled')
    .endIf();

rule.endIf() ⇒ this

Ends condition

Kind: instance method of Rule

rule.default(value) ⇒ this

Sets default value, when item is not filled. Empty string is considered as a value.

Kind: instance method of Rule

rule.contains(string, message) ⇒ this

Searches for occourence of the string

Kind: instance method of Rule

rule.isNumeric(message) ⇒ this

Input shoud be numeric

Kind: instance method of Rule

rule.isEmail(message) ⇒ this

Input should be the email

Kind: instance method of Rule

rule.isUrl(message, options) ⇒ this

Validates non-empty strings as url

Kind: instance method of Rule

Example

validator.isUrl('Message', {
      protocols: ['http','https','ftp'],
      require_tld: true,
      require_protocol: false,
      require_host: true,
      require_valid_protocol: true,
      allow_underscores: false,
      host_whitelist: false,
      host_blacklist: false,
      allow_trailing_dot: false,
      allow_protocol_relative_urls: false
 })

rule.isRequired(message) ⇒ this

Input is required

Kind: instance method of Rule

rule.isRequiredIfPresent(message) ⇒ this

Input is required, only when atributte is not missing (not undefined)

Kind: instance method of Rule

rule.isFileMime(message, types) ⇒ this

Validates File mime types. Compatible with browser-side File class and prg-uploader

Kind: instance method of Rule

rule.isFileMaxLength(message, types) ⇒ this

Validates File mime types. Compatible with browser-side File class and prg-uploader

Kind: instance method of Rule

rule.toInt(message) ⇒ this

Makes the integer from an input

Kind: instance method of Rule

rule.toBoolean(message) ⇒ this

Makes the boolean from an input

Kind: instance method of Rule

rule.toFileData() ⇒ this

Substracts data from the file. It actually extracts ".data" property from object, but just on the serverside

Kind: instance method of Rule

Rule

Kind: global class

• Rule
  • new Rule()
  • new Rule(rules)
  • .is(action, [message], [args]) ⇒ this
  • .to(action, [args]) ⇒ this
  • .if(action) ⇒ this
  • .endIf() ⇒ this
  • .default(value) ⇒ this
  • .contains(string, [message]) ⇒ this
  • .isNumeric([message]) ⇒ this
  • .isEmail([message]) ⇒ this
  • .isUrl([message], [options]) ⇒ this
  • .isRequired([message]) ⇒ this
  • .isRequiredIfPresent([message]) ⇒ this
  • .isFileMime(message, types) ⇒ this
  • .isFileMaxLength(message, types) ⇒ this
  • .toInt([message]) ⇒ this
  • .toBoolean([message]) ⇒ this
  • .toFileData() ⇒ this

new Rule()

Single attribute rule contructor

new Rule(rules)

Creates an instance of Rule.

rule.is(action, message, args) ⇒ this

Add any validator to rule

Kind: instance method of Rule

Example

validator.add('property')
    .is(value => value.match(/xy/))

rule.to(action, args) ⇒ this

Adds sanitizer (filter) which converts value to different type

Kind: instance method of Rule

Example

validator.add('property')
    .to(value => parseInt(value, 10));

rule.if(action) ⇒ this

Adds confition. It can filter validators by context or with custom function

Kind: instance method of Rule

Example

validator.add('property')
    .if((value, data, context) => data.otherProperty)
        .isRequire('Should be filled')
    .endIf();

rule.endIf() ⇒ this

Ends condition

Kind: instance method of Rule

rule.default(value) ⇒ this

Sets default value, when item is not filled. Empty string is considered as a value.

Kind: instance method of Rule

rule.contains(string, message) ⇒ this

Searches for occourence of the string

Kind: instance method of Rule

rule.isNumeric(message) ⇒ this

Input shoud be numeric

Kind: instance method of Rule

rule.isEmail(message) ⇒ this

Input should be the email

Kind: instance method of Rule

rule.isUrl(message, options) ⇒ this

Validates non-empty strings as url

Kind: instance method of Rule

Example

validator.isUrl('Message', {
      protocols: ['http','https','ftp'],
      require_tld: true,
      require_protocol: false,
      require_host: true,
      require_valid_protocol: true,
      allow_underscores: false,
      host_whitelist: false,
      host_blacklist: false,
      allow_trailing_dot: false,
      allow_protocol_relative_urls: false
 })

rule.isRequired(message) ⇒ this

Input is required

Kind: instance method of Rule

rule.isRequiredIfPresent(message) ⇒ this

Input is required, only when atributte is not missing (not undefined)

Kind: instance method of Rule

rule.isFileMime(message, types) ⇒ this

Validates File mime types. Compatible with browser-side File class and prg-uploader

Kind: instance method of Rule

rule.isFileMaxLength(message, types) ⇒ this

Validates File mime types. Compatible with browser-side File class and prg-uploader

Kind: instance method of Rule

rule.toInt(message) ⇒ this

Makes the integer from an input

Kind: instance method of Rule

rule.toBoolean(message) ⇒ this

Makes the boolean from an input

Kind: instance method of Rule

rule.toFileData() ⇒ this

Substracts data from the file. It actually extracts ".data" property from object, but just on the serverside

Kind: instance method of Rule