ahmadjoya / generate-password-lite

generate-password-lite is usable for every javascript and typescript based project like react, vue, node, etc. it used to generate passwords that may contain alphabets, number and symbols. The options parameter enables the user to enable or disable the characters that are used to generate random password.
MIT License
36 stars 1 forks source link
angular generate-password javascript js-library nodejs password-generator reactjs vuejs



npm Info

npm Version npm Release Version npm Downloads npm Package License

github Stars github Forks github Contributors github Issues


generate-password-lite

generate-password-lite is usable for every typescript and typescript based project like react, vue, node, etc. it used to generate passwords that may contain alphabets, number and symbols. The options parameter enables the user to enable or disable the characters that are used to generate random password.

The characters that may be choosen from are

The user may also specify the minimum number of character for each type.

Installation

npm install generate-password-lite

or

yarn add generate-password-lite

Usage

For the password to be generated, parameters are able to pass as an optional options object.

import { GeneratePassword } from "generate-password-lite";

const password = GeneratePassword({
  length: 14,
  symbols: true,
});

console.log(password);

If no parameter is passed, the default parameter will be taken as :

options = {
  length: 10,
  lowercase: true,
  uppercase: true,
  numbers: true,
  symbols: false,
  exclude: "",
  minLengthLowercase: 1,
  minLengthUppercase: 1,
  minLengthNumbers: 1,
  minLengthSymbols: 0,
};

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
lowercase* Boolean, put lowercase letters in password true
uppercase* Boolean, put uppercase letters in password. true
numbers* Boolean, put numbers in password. true
symbols* Boolean, put symbols in password. false
exclude String, characters to be excluded from password. ''
minLengthLowercase only if lowercase is set to true, minLengthLowercase will create a password that will have minimum number of lower case characters in the password. 1
minLengthUppercase only if uppercase is set to true, minLengthUppercase will create a password that will have minimum number of upper case characters in the password. 1
minLengthNumbers only if numbers is set to true, minLengthNumbers will create a password that will have minimum number of numbers in the password. 1
minLengthSymbols only if symbols is set to true, minLengthSymbols will create a password that will have minimum number of symbols in the password. 1

Example

const { GeneratePassword } = "generate-password-lite";

const password = GeneratePassword();

console.log(password);

In the above case, no parameter is passed as option. Therefore the default values will be taken - which will have alphabets, both upper and lower case, numbers, and will be of length 10 characters.

xDU6izb3PV;
const password = GeneratePassword({ length: 25 });
console.log(password);

The password generated is like this

U4c3KpQP5UrbZgTcrqMgFeI3R;
options = {
  exclude : 'abc567XYZ';
}

password = GeneratePassword(options);

console.log(password);

The generated password wouldn't has none of 'abc567XYZ' characters

J9yCfttQNj;

License

generate-password-lite is licensed under the MIT License. See the LICENSE file for more details.