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

Manage permissions for the whole team

Collaborators list

Stats

Try it out

Keywords

Dependencies

Dependents (65)