validator.js

A Laravel styled JavaScript Object/Form/JSON validation library. Laravel Validation

• Support mixin validation rules
• Support recursive validation on complicate objects
• Support user-defined validator

validator.js is easy to use in form or JSON validation, and it is extensible.

Example

var example = {
      text: 'Hello world!',
      date: '2015-07-07',
      attachment: {
        name: 'note1',
        count: 1,
      },
      comments: null,
    },
    rules = {
      text: 'required|string',
      date: 'date|date_format:yyyy-MM-dd',
      attachment: {
        name: 'required|string',
        content: 'integer',
      },
      comments: 'array',
    };

console.log(Validator.validate(example, rules));
// => {status: 'failed', [{object: [Object], field: "comments", rule: "array"}]}

Basic Usage

Import validator.js library(for native JavaScript code)

<script type="text/javascript" src="./validator.js"></script>

Or

<script type="text/javascript" src="./dist/validator.min.js"></script>

Initialization(skip this if you are using native JavaScript code)

Node.js

npm install js-validator-ext --save

var validator = require('js-validator-ext');

RequireJS

requirejs(["./validator"], function(validator) {
  ...
});

Sea.js

define(function (require, exports, module) {
  var validator = require('./validator');
  ...
});

Make rules

You can have different rules for a single field, using | as the separator.

var rules = {
  text: 'required|string',
  date: 'date|date_format:yyyy-MM-dd',
  comments: 'integer',
};

About string escape

When '|', ':' or ',' has to be in your rule's values, please add '\\' in front of them, just like this:

var person = {
      nickname: 'Harry|Poter'
    },
    rules = {
      nickname: 'in:Harry\\|Potter,Hermione\\:Granger,Ron\\,Weasley'
    }

Validate the rules

// Validator.validate if you are using native JavaScript code
validator.validate(object_to_be_tested, rules);

Result

Return an object with 'status' and 'rejects' properties.

If the validated object meets all the rules, the 'status' property will be 'success' and the 'rejects' array will be empty; otherwise 'status' will be 'failed' and 'rejects' will contain details that causes the failure.

Add a validator

You can use add() Function to add a validator, along with a name as its first argument and a validation method as second argument. Validation method can either be RegExp object or Function. When it's a Function, its first argument is the object to be tested, the second argument is the value of current validating field, and it should return true when the validation succeeded.

// Validator.add if you are using native JavaScript code
validator.add('older_than', function (object, value, age) {
  return value > age;
});

var rules = {
  age: 'integer|older_than:17',
};

Configuration

// Validator.setConfig if you are using native JavaScript code
validator.setConfig({...});

Available configurations

resumeOnFailed

Default: false

Whether the validation continues when it failed on any rule.

Available Validation Rules

accepted

The field under validation must be yes, on, 1, or true. This is useful for validating "Terms of Service" acceptance.

after:date

The field under validation must be a value after a given date.

alpha

The field under validation must be entirely alphabetic characters.

alpha_dash

The field under validation must be entirely alphabetic characters.

alpha_num

The field under validation must be entirely alpha-numeric characters.

array

The field under validation must be of type array.

before:date

The field under validation must be a value preceding the given date.

between:min,max

The field under validation must have a size between the given min and max. Strings, numerics and files(FileList/File) are evaluated. Files are evaluated in kilobytes.

boolean

The field under validation must be able to be cast as a boolean. Accepted input are true, false, 1, 0, "1", "0", '1' and '-'.

date

The field under validation must be a valid date according to the Date.parse function.

date_format:format

The field under validation must match the format defined according to the meizz's dateFormat function.

different:field

The given field must be different than the field under validation.

digits:value

The field under validation must be numeric and must have an exact length of value.

digits_between:min,max

The field under validation must have a length between the given min and max.

email

The field under validation must be formatted as an e-mail address.

in:foo,bar,...

The field under validation must be included in the given list of values.

integer

The field under validation must have an integer value.

ip

The field under validation must be formatted as an IP address.

max:value

The field under validation must be less than or equal to a maximum value. Strings, numerics and files(FileList/File) are evaluated. Files are evaluated in kilobytes.

mimes:foo,bar,...

The string under validation must have a MIME type corresponding to one of the listed extensions.

min:value

The field under validation must have a minimum value. Strings, numerics and files(FileList/File) are evaluated. Files are evaluated in kilobytes.

not_in:foo,bar,...

The field under validation must not be included in the given list of values.

numeric

The field under validation must have a numeric value.

regex

The field under validation must match the given regular expression.

required

The field under validation must be present in the input data.

required_if:field,value,...

The field under validation must be present if the field is equal to any value. The relationship between each field is AND.

required_with:foo,bar,...

The field under validation must be present only if any of the other specified fields are present.

required_with_all:foo,bar,...

The field under validation must be present only if all of the other specified fields are present.

required_without:foo,bar,...

The field under validation must be present only when any of the other specified fields are not present.

required_without_all:foo,bar,...

The field under validation must be present only when all of the other specified fields are not present.

same

The given field must match the field under validation.

size:value

The field under validation must have a size matching the given value. For string data, value corresponds to the number of characters. For numeric data, value corresponds to a given integer value. For file(FileList/File), size corresponds to the file size in kilobytes.

string

The field under validation must be a string type.

url

The field under validation must be formatted as an URL. It does not support non-English urls.

Demo Entries

./test/index.html native JavaScript support test

./test/node.js Node.js support test

./test/requirejs.html RequireJS support test

./test/seajs.html Sea.js support test