This password generator will generate a random string from a range of characters available in the BMP (Basic Multilingual Plane) Unicode character set.
This offers character support in the:
- decimal range, i.e. [0, 65535]
- hexadecimal range, i.e. [0x0000, 0xFFFF]
- unicode range, i.e. [\u0000, \uFFFF]
Astral plane characters are currently not supported.
npm install unicode-passgen
bower install unicode-passgen
var unicodePassgen = require('unicode-passgen');<script type="text/javascript" src="/path/to/dist/unicode-passgen.min.js"></script>
<script type="text/javascript">
var unicodePassgen = require('unicode-passgen');
</script>The unicodePassgen object provides a single method: generate
generate will generate a random string of length characters from the entire
BMP Unicode character set by default.
By setting options, the generator can limit the available character set to fit
your particular domain.
The options must be an object that defines at least one of the two properties,
include or exclude. These properties define which characters should be
included as a character set to draw from, or characters that should be
explicitly excluded, respectively. Each property should be defined as an array
of objects, each containing the chars property and an optional min property.
The chars property defines an array of arrays representing a single character,
or range of characters from a starting character to the ending character.
A few pre-defined values may also be used for convenience, like alpha_numeric.
See below for a list of valid pre-defined values.
A range of characters must be set from a lower value to a higher value.
For example, 'a' (hex 0x61, decimal 97) appears before
'z' (hex 0x7A, decimal 122) in BMP, so the set should be provided ['a', 'z'],
i.e. from 'a' to 'z'.
NOTE: Each character in the character set is unique and exists only once. Defining the same character multiple times does not increase the character's probability of appearing in the generated string relative to other characters.
The min property denotes that the defined character set group must have at
least that many characters represented in the generated string. By default,
this value is zero.
The following pre-defined words may be used in a chars array for convenience
in defining common character sets. See below for an example.
alpha- Equivalent to[['a', 'z'], ['A', 'Z']]numeric- Equivalent to[['0', '9']]alpha_numeric- Equivalent to[['a', 'z'], ['A', 'Z'], ['0', '9']]symbols- All lower-ASCII printable symbols, i.e. any of the following:!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~Equivalent to[[33, 47], [58, 64], [91, 96], [123, 126]]alpha_lower- Equivalent to[['a', 'z']]alpha_upper- Equivalent to[['A', 'Z']]alpha_numeric_lower- Equivalent to[['a', 'z'], ['0', '9']]alpha_numeric_upper- Equivalent to[['A', 'Z'], ['0', '9']]
Characters may be defined in decimal, hexadecimal, unicode, or string format.
For example, you may define the letter 'Q' as any of the following:
- in decimal:
81 - in hexadecimal:
0x51or0x0051 - in unicode:
\u51or\u0051 - as a string:
'Q'
// The options syntax
var options = {
include: [
{
chars: [
[rangeStart [, rangeEnd]],
...
[singleCharacter],
...
[singlePredefinedValue],
...
],
min: integer
...
},
...
],
exclude: [
{
chars: [
[rangeStart [, rangeEnd]],
...
[singleCharacter],
...
[singlePredefinedValue],
...
]
},
...
]
}The following example options denote the generator to:
- Draw only from the following alphanumeric character set:
abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789
- Require at least 2 characters be from the character set:
0123456789
- Require at least 1 character be from the character set:
i
- Exclude the characters:
ilo01
var options = {
include: [
{
chars: [
['alpha']
]
},
{
chars: [
['numeric']
],
min: 2
},
{
chars: [
['i']
],
min: 1
}
],
exclude: [
{
chars: [
['i'],
['l'],
['o'],
['0', '1']
]
}
]
}Interpreting this, the generator will require that:
- The character set only draw from the following subset:
abcdefghjkmnpqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ23456789
- At least 2 characters must be present from the character set:
23456789
- No
icharacter will be present (because exclusion takes precedence)
unicodePassgen.generate(13, options); // aqf8sQf33Gsk9
Generate a random 10-character string from the entire BMP Unicode character set
unicodePassgen.generate(10); // ⚢㦴缔碅Χꂨ〱㋃桷䳟껫
// The above is identical to including the following options
var options = {
include: [
{
chars: [[0x0000, 0xFFFF]]
}
]
}
unicodePassgen.generate(10, options); // ⚢㦴缔碅Χꂨ〱㋃桷䳟껫Generate a random 10-character string from the Latin alphabet subset of lower-case characters from 'a' to 'z'.
[['a', 'z']] is equivalent to [['alpha_lower']]
var options = {
include: [
{
chars: [['a', 'z']]
}
]
};
unicodePassgen.generate(10, options); // sqxkhvjaydGenerate a random 10-character string from the Latin alphabet subset of lower-case characters from 'a' to 'z', excluding 'i', 'j', 'k', 'l' and 'o'
[['a', 'z']] is equivalent to [['alpha_lower']]
var options = {
include: [
{
chars: [['a', 'z']]
}
],
exclude: [
{
chars: [['i', 'l'], ['o']]
}
]
};
unicodePassgen.generate(10, options); // aszvpwaeusGenerate a random 10-character alphanumeric string where at least 8 digits must be present
[['a', 'z']] is equivalent to [['alpha_lower']]
[['0', '9']] is equivalent to [['numeric']]
var options = {
include: [
{
chars: [['a', 'z']]
},
{
chars: [['0', '9']],
min: 8
}
]
};
unicodePassgen.generate(10, options); // 9fs9704187Generate a random 10-character string where at least 8 'f' characters are present
[['a', 'z']] is equivalent to [['alpha_lower']]
var options = {
include: [
{
chars: [['a', 'z']]
},
{
chars: [['f']],
min: 8
}
]
};
unicodePassgen.generate(10, options); // ffffzfffefGenerate a random 10-character string where at least 20 characters are digits.
Note that the required minimum values will override the provided length if they exceed it
[['0', '9']] is equivalent to [['numeric']]
var options = {
include: [
{
chars: [['0', '9']],
min: 20
}
]
};
unicodePassgen.generate(10, options); // 54843463349183889425Generate a random 10-character string of digits, but exclude the entire BMP character set (which also excludes the digit characters).
Note that excluding all of the included characters will cause an empty string to be returned by the generator
[['0', '9']] is equivalent to [['numeric']]
var options = {
include: [
{
chars: [['0', '9']]
}
],
exclude: [
{
chars: [[0x0000, 0xFFFF]]
}
]
};
unicodePassgen.generate(10, options); //npm test
MIT