Skip to content
A simple JavaScript validation library that doesn't interfere
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist Improved `ignoreNull` Jun 26, 2017
src Improved `ignoreNull` Jun 26, 2017
test Added ignoreNull Mar 10, 2017
.gitignore ... Apr 5, 2017
.jshintrc Performance update Jul 20, 2016
.travis.yml Node update Jul 19, 2016
LICENSE Initial commit Jul 15, 2016 updated readme Apr 5, 2017
bower.json Improved Compilation Oct 3, 2016
gulpfile.js Implemented Rollup, updated date test Nov 22, 2016
package.json Improved `ignoreNull` Jun 26, 2017
rollup.config.js Implemented Rollup, updated date test Nov 22, 2016


A simple validation library that doesn't interfere

release npm CDNJS Build Status downloads

ApproveJs doesn't automatically attach itself to input change events or form submit events. It also doesn't manipulate the DOM for you by automatically displaying errors. This allows you to automate validation how you want.

With a single method (approve.value()), you can decide how to handle validation.

If you like to be in control or have a little OCD like me, ApproveJs is for you.

ApproveJs is also easily extended with custom tests.



Download Latest Release

Unzip into your desired folder and add a script tag to the library before the end of your closing <body> tag

<script src="path/to/approve.min.js"></script>

In your terminal run:

$ bower install approvejs

Add a script tag to the library before the end of your closing <body> tag

<script src="path/to/bower_components/approvejs/dist/approve.min.js"></script>

Add a script tag to the library CDN url before the end of your closing <body> tag

<script src="[version]/approve.min.js"></script>

Get the cdn urls from here

Many thanks to cdnjs who kindly hosts ApproveJS through a reliable CDN


In your terminal run:

$ npm install approvejs

or if you're using Yarn

$ yarn add approvejs

Require approvejs.

var approve = require('approvejs');


ApproveJS exposes a single method value that takes two parameters.

The first parameter is the value to validate and the second is the set of rules to test against.

var rules = {
    required: true,
    email: true

var result = approve.value('', rules);

The returned result contains two properties:

    approved: boolean,
    errors: []

Accessing Errors

You can access errors returned by the result in one of two ways:

Errors Property
var i = result.errors.length;
while(i--) {
.each Method

The result object exposes an each() method for easily getting to errors.

result.each(function(error) {

Read documentation here.

If you would like to contribute to the project, please read contributing.

You can’t perform that action at this time.