Skip to content
This repository has been archived by the owner on Feb 9, 2024. It is now read-only.

NodeJS library for generating cryptographically-secure passwords.

License

Notifications You must be signed in to change notification settings

LukeNotable/generate-password

 
 

Repository files navigation

Generate Password Build Status codecov

Generate-Password NPM

Generate Password is a (relatively) extensive library for generating random and unique passwords.

Install

$ npm install generate-password --save

Usage

generate([options])

Generate one password with the given options. Returns a string.

var generator = require('generate-password');

var password = generator.generate({
	length: 10,
	numbers: true
});

// 'uEyMTw32v9'
console.log(password);

generateMultiple(amount[, options])

Bulk generate multiple passwords at once, with the same options for all. Returns an array.

var generator = require('generate-password');

var passwords = generator.generateMultiple(3, {
	length: 10,
	uppercase: false
});

// [ 'hnwulsekqn', 'qlioullgew', 'kosxwabgjv' ]
console.log(passwords);

Available options

Any of these can be passed into the options object for each function.

Name Description Default Value
length Integer, length of password. 10
numbers* Boolean, put numbers in password. false
symbols* Boolean or String, put symbols in password. false
lowercase* Boolean, put lowercase in password true
uppercase* Boolean, use uppercase letters in password. true
excludeSimilarCharacters Boolean, exclude similar chars, like 'i' and 'l'. false
exclude String, characters to be excluded from password. ''
strict Boolean, password must include at least one character from each pool. false

*At least one should be true.

Using this with a browser

As browsers don't have the "require" method that Node.js does, this module doesn't work in web environments. Instead generate-password-browser can be used.

About

NodeJS library for generating cryptographically-secure passwords.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 97.0%
  • Shell 3.0%