Install with npm
$ npm install random.org-javascript
ES6
import random from "random.org-javascript";
CommonJS
const random = require("random.org-javascript");
Basic Example
You can use Promise
random.generateInteger(1, 50, 10, "Decimal").then(response => {
console.log(response); // => Array<number>[10]
}).catch(error => {
console.log(error);
});
or async
try {
let response = await random.generateInteger(10, 50, 10, "Decimal")
console.log(response); // => Array<number>[10]
} catch (error) {
console.log(error);
}
Generating Random Number
random.generateInteger(1, 50, 10, "Decimal").then(response => {
console.log(response); // => Array<number>[10]
}).catch(error => {
console.log(error);
});
Generating Random Number Sequence
random.generateIntegerSequences(1, 50).then(response => {
console.log(response); // => Array<number>[50]
}).catch(error => {
console.log(error);
});
Generating Random String
random.generateStrings(10, 5).then(response => {
console.log(response); // => Array<string[5]>[10]
}).catch(error => {
console.log(error);
});
Getting Quota
random.getQuota().then(response => {
console.log(response); // => 1000000 (If you have not generated anything yet)
}).catch(error => {
console.log(error);
});
Generates true random integers within a user-defined range
- Parameters:
min
—number
— The smallest value allowed for each integer.max
—number
— The largest value allowed for each integer.amount
—number[optional]
— The number of integers requested.format
—string[optional]
— The format that will be used to print the numbers, i.e., binary, octal, decimal or hexadecimal.
- Returns:
Promise<Array<number>>
— Promise Array of number.
Generates uniform or multiform sequences of true random integers within user-defined ranges.
- Parameters:
min
—number
— The lower bound of the interval (inclusive).max
—number
— The upper bound of the interval (inclusive).
- Returns:
Promise<Array<number>>
— Promise Array of number.
Generates true random strings.
- Parameters:
amount
—number
— The number of strings requested.length
—number
— The length of the strings. All the strings produced will have the same length.enableNumbee
—boolean[optional: true]
— Determines whether digits (0-9) are allowed to occur in the strings.enableUppercase
—boolean[optional: true]
— Determines whether uppercase alphabetic characters (A-Z) are allowed to occur in the strings.enableLowercase
—boolean[optional]: true
— Determines lowercase alphabetic characters (a-z) are allowed to occur in the strings.enableUnique
—boolean[optional: true]
— Determines whether the strings picked should be unique (as a series of raffle tickets drawn from a hat) or not (as a series of die rolls).
- Returns:
Promise<Array<string>>
— Promise Array of String.
This allows you to examine your quota at any point in time. The quota system works on the basis of IP addresses. Each IP address has a base quota of 1,000,000 bits. When your client makes a request for random numbers (or strings, etc.), the server deducts the number of bits it took to satisfy your request from the quota associated with your client's IP address.
- Returns:
Promise<number>
— Promise Number