@netsells/password-validator

Install

npm install password-validator

Usage

var passwordValidator = require('password-validator');

// Create a schema
var schema = new passwordValidator();

// Add properties to it
schema
.is().min(8)                                    // Minimum length 8
.is().max(100)                                  // Maximum length 100
.has().uppercase()                              // Must have uppercase letters
.has().lowercase()                              // Must have lowercase letters
.has().digits()                                 // Must have digits
.has().not().spaces()                           // Should not have spaces
.is().not().oneOf(['Passw0rd', 'Password123']); // Blacklist these values

// Validate against a password string
console.log(schema.validate('validPASS123'));
// => true
console.log(schema.validate('invalidPASS'));
// => false

// Get a full list of rules which failed
console.log(schema.validate('joke', { list: true }));
// => [ 'min', 'uppercase', 'digits' ]

Rules

Rules supported as of now are:

Rules	Descriptions
digits()	specifies password must include digits
letters()	specifies password must include letters
lowercase()	specifies password must include lowercase letters
uppercase()	specifies password must include uppercase letters
symbols()	specifies password must include symbols
spaces()	specifies password must include spaces
min(len)	specifies minimum length
max(len)	specifies maximum length
oneOf(list)	specifies the whitelisted values
not([regex])	inverts the result of validations applied next
is()	inverts the effect of not()
has([regex])	inverts the effect of not() and applies a regex (optional)

Options

The following options can be passed to validate method:

• list - If set, validate method returns a list of rules which failed instead of true/false.

Resources

• API Reference
  • latest
  • others
• Wiki
• Changelog

For APIs of other older versions, head to Wiki.

License

MIT License