random-string

Simple Module for generating Random Strings

Getting Started

Install the module with: npm install random-string

var randomString = require('random-string');
var x = randomString(); // x contains now a random String with the length of 8

Documentation

You can call the randomString-Method with additional options for specifing how long your resulting string should be and which characters to include

// e.g. you want a string with a length of 20 
var x = randomString({length: 20});

options

options.length

number - the length of your resulting string (DEFAULT: 8)

options.numeric

boolean - should your resulting string contain numbers (from 0-9) (DEFAULT: true)

options.letters

boolean - should your resulting string contain letters (from a-z, lower and uppercase) (DEFAULT: true)

options.special

boolean - should your resulting string contain any of these special characters (!$%^&*()_+|~-=`{}[]:;<>?,./) (DEFAULT: false)

options.exclude

array - removes characters from resulting string Note: Lowercase letters will not remove uppercase letters

Examples

// that would be a call with all options (hint: thats a call with all defaults, und the options wouldnt be necessary in that case!) 
var x = randomString({
  length: 8,
  numeric: true,
  letters: true,
  special: false,
  exclude: ['a', 'b', '1']
});

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

random-string

random-string

Getting Started

Documentation

options

options.length

options.numeric

options.letters

options.special

options.exclude

Examples

Contributing

Release History

Contributors

License

We ♥ your boss

Collaborators list

Stats

Try it out

Keywords

Dependencies

Dependents (66)