No Description
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
s2 cb6bbee3b1 add one more test 1 year ago
lib just nerdy whitespace stuff 1 year ago
.gitignore initial commit 3 years ago
.jscsrc add jscsrc file so it's easier to contribute code 1 year ago
CHANGELOG.md 1.1.0 changelog 1 year ago
README.md just a newline 1 year ago
package.json update package version 1 year ago
tests.js add one more test 1 year ago

README.md

secure-random-string

Node.js module that generates a cryptographically secure random string with a given length

Usage

var srs = require('secure-random-string');

Default behavior: Generate a random string 32 characters long.

// Sync
var result = srs();

// Async
srs(function(err, sr) {
	console.log(sr);
});

Options: length

Optionally, you can specify a ‘length’ option to specify a length.

// sync
var result = srs({length: 256});

// async
srs({length: 256}, function(err, sr) {
	console.log(sr);
});

Options: alphanumeric

Optionally, you can specify a ‘alphanumeric’ option to get a alphanumerical chars only.

// sync
var result = srs({alphanumeric: true});

// async
srs({alphanumeric: true}, function(err, sr) {
	console.log(sr);
});

Error handling

An error is possible if there is not enough accumulated entropy to generate cryptographically strong data. In other words, this will not block even if all entropy sources are drained. Note that the sync API throws an exception, while the async API returns the error to the callback.

Author

Simon Santoro

Contributors

Mark Stosberg
Sandro Gomez

License

MIT