What is this ?
this is a js validation library, works on the browser as well as on the server, it is well tested with the help of QUnit. hope you find it helpful.
On the Browser:
if you want to use "itiz" on the browser, just download and then load the itiz.min.js file.
<script src='./your_project/path/to/itiz.min.js'></script>
On the Server:
if you are using some server side js frameworks like Nodejs, you just need to npm install it
npm i itiz
and the simply require it as you do with any other package
API & Usage
itiz(param)
this is the main function, this will return an object of all the helpful methods that you can use.
param is required, you will get an error if you dont pass anything
those are the methods you get after calling itiz() with params;
.email()
this method will validate the email you pass to the itiz() function
usage
// this here will return an object (wich is a chain of all the other method, // or false if the email is not valid ;
.length(params)
this method will validate the string you give to the itiz() function
usage
// will return an object (wich is a chain of all the other method or false if itiz not valid lengthmax: 20;
params
parameters are required, and it must be an object that has one of this:
min: the minimum length of the string
max: the maximum length of the string
.same()
this method will ensure if two (or more) values are the same (equal) usage
// this will return an object (wich is a chain of all the other method or false if the two values are not the same ; // You can pass as many values as you can to check if they are all the same // e.g: ;
.url([params])
this method here will validate if a given url is valid
usage
// this will return an object (wich is a chain of all the other method or false if the two values are not the same ;
params
this method accepts one parameter wich is a boolean value (default is false).
if you pass true to it, it will ensure that that the url must contain the protocol (http/https)
// e.g: // this will return false
.contains(params)
this method will validate if a string or array contains a specific value;
this method will return only boolean value (true/false), it wont return an object
usage
// with strings // will return true // with arrays // will return false
.notEmpty()
this method will validate if an array/object/string is not empty
it will return an object if valid or false if not
usage
// will return an object with the other helpful methods // will return an false, well cause its empty
.empty()
this method will validate if an array/object/string is empty
it will return an object if valid or false if not
usage
// will return false // will return an object with the other helpful methods
.upperCase([params])
this method will validate if an a string is upper case
it will return an object if valid or false if not
usage
// will return an object // will return false
params
this method accepts one optional parameter wich is an object with an index property,
that can be a number or array of numbers. this parameter will ensure that the index given is upper-case
// e.g: // will return an object, cause its valid :)
.lowerCase([params])
this method will validate if an a string is lower case
it will return an object if valid or false if not
usage
// will return an object // will return false
params
this method accepts one optional parameter wich is an object with an index property, same as the upperCase() method,
that can be a number or array of numbers.
// e.g: // will return an object, cause its valid :)
Contribution
if you found this library helpful and you want to contribute, maybe add another helpful method or anything..., please go ahead.