string-enumerator v1.0.0
string-enumerator
0 dependencies
An NPM package for enumerating strings based off of a set of characters. Great for blind brute forcing and fuzzing.
Example
var EnumString = require('string-enumerator')
var charset = 'abcd123';
var eString = new EnumString.EnumString(charset);
for (var i = 0; i < 20; i++) {
console.log(eString.nextString())
}
// Logs: a b c d 1 2 3 aa ab ac ad a1 a2 a3 ba bb bc bd b1 b2
API
- EnumString.EnumString (Constructor)
- EnumString.prototype.setIndex
- EnumString.prototype.getIndex
- EnumString.prototype.getString
- EnumString.prototype.nextString
- EnumString.prototype.prevString
- EnumString.prototype.getIndexFromStr
- EnumString.letters
- EnumString.digits
- EnumString.symbols
EnumString.EnumString
EnumString.EnumString is the main constructor for the EnumString object, and must be instatiated to utilize this package. The constructor requires that a string or array of characters is passed as the first argument, which dictates the character set that the object will enumerate through.
Syntax:
var charset = 'abcd123';
var eString = new EnumString.EnumString(charset);
EnumString.prototype.setIndex
Sets the current index of enumeration to a specified number.
Syntax:
eString.setIndex(2);
EnumString.prototype.getIndex
Returns the current enumeration index.
Syntax:
eString.setIndex(4);
console.log(eString.getIndex()); // Logs "4"
EnumString.prototype.getString
Gets the string identified by the current enumeration index.
Syntax:
// Assuming the charset 'abcd123'
eString.setIndex(0);
console.log(eString.getString()); // Logs 'a'
eString.setIndex(1);
console.log(eString.getString()); // Logs 'b'
eString.setIndex(7);
console.log(eString.getString()); // Logs 'aa'
EnumString.prototype.nextString
Returns the string at index
then increases index by one, for use in loops.
Syntax:
// Assuming the charset 'abcd123'
eString.setIndex(3);
for (var i = 0; i < 3; i++) {
console.log(eString.nextString());
}
// Logs: d 1 2
EnumString.prototype.prevString
Returns the string at index
then decreases index by one, for use in loops.
Syntax:
// Assuming the charset 'abcd123'
eString.setIndex(8);
for (var i = 0; i < 3; i++) {
console.log(eString.prevString());
}
// Logs: ab aa 3
EnumString.prototype.getIndexFromStr
Gets the index that would correspond to the given string.
Syntax:
// Assuming the charset 'abcd123';
console.log(eString.getIndexFromStr('a')); // Logs: '0'
console.log(eString.getIndexFromStr('2')); // Logs: '5'
console.log(eString.getIndexFromStr('aa')); // Logs: '7'
EnumString.letters
A quality of life string containing upper and lowercase letters
Syntax:
console.log(EnumString.letters); // Logs: 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
EnumString.digits
A quality of life string containing numbers 0-9
Syntax:
console.log(EnumString.digits); // Logs: '0123456789'
EnumString.symbols
A quality of life string containing some symbols
Syntax:
console.log(EnumString.symbols); // Logs: '`~!@#$%^&*()-_=+[{]}|\\;:\'",<.>/?'
6 years ago