1.0.7 • Published 4 months ago

random-string-generator v1.0.7

Weekly downloads
1,587
License
MIT
Repository
github
Last release
4 months ago

random

Javascript random string generator, the length and scope can be custom defined.

Install

By bower:

bower install random-string-generator

By npm:

npm install random-string-generator

By yarn:

yarn add random-string-generator

Documention

random([length] [, type]);

length:

Random string's length, default is 12.

random(); // 'qCCm2Yoyycjm' or others
random(12); // 'qCCm2Yoyycjm' or others

type:

You can generate different variant of strings based on the choices available, default is 'alphanumeric':

1. alphanumeric

To genereate alphanumeric characters. example

random('alphanumeric'); // 'qCCm2Yoyycjm' or others
2. numeric

To generate numeric characters. example

random('numeric'); // '222295328374' or others
3. upper

To generate upper case alphabetic characters. example

random('upper'); // 'ELYGLGBVKLUE' or others
4. lower

To generate lower case alphabetic characters. example

random('lower'); // 'pivohkmuzxrv' or others
5. uppernummeric

To generate upper case numeric characters. example

random('uppernumeric'); // '8DOUIL7RW8MW' or others
6. lowernummeric

To generate upper case numeric characters. example

random('lowernumeric'); // 'k0oooqv77wrq' or others
7. scoped:.+

To generate upper case numeric characters. example

random('scoped:ABCDEF'); // 'ACBBCAFCEDAA' or others

Usage

Use with HTML <script> tag:

<script src="/bower_components/random-string-generator/dist/random.js"></script>

other js field you can write:

<script>
  console.log(random());  // 'qCCm2Yoyycjm' or others
</script>

Use with require.js:

define(["./bower_components/random-string-generator/dist/random.js"], function(random) {
    console.log(random());  // 'qCCm2Yoyycjm' or others
  }
);

Use with node modules:

var random = require('random-string-generator');

console.log(random());  // 'qCCm2Yoyycjm' or others

Example

var random = require('random-string-generator');
var result = random(100000, 'scoped:ABCDE');
var stat = [0, 0, 0, 0, 0];
for (var i in result) {
    var s = result[i];
    switch (s) {
        case 'A': stat[0]++; break;
        case 'B': stat[1]++; break;
        case 'C': stat[2]++; break;
        case 'D': stat[3]++; break;
        case 'E': stat[4]++; break;
        default: break;
    }
}

function output(char, num) {
    return char + ': ' + stat[num] / 1000 + '%';
}

console.log(output('A', 0));
console.log(output('B', 1));
console.log(output('C', 2));
console.log(output('D', 3));
console.log(output('E', 4));

/*
 * The results may be:
 *
 * A: 20.044%
 * B: 19.969%
 * C: 19.93%
 * D: 19.991%
 * E: 20.066%
 *
 * or some others.
*/

Contributing

Instead of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.

License

Licensed under the MIT license.

1.0.7

4 months ago

1.0.6

4 months ago

1.0.5

4 months ago

1.0.4

4 months ago

1.0.2

9 months ago

1.0.1

2 years ago

1.0.0

6 years ago

0.2.0

7 years ago

0.1.0

8 years ago