@ethico/fakerandom
The Fake Random package is a versatile random data generator that allows you to generate various types of realistic and randomized data.
Installation
You can install the package via npm:
npm install @ethico/fakerandom
Make sure you have Node.js installed.
Usage
Import the functions you need from the package using ES6 module syntax:
import {
frFloat,
frInt,
frPhone,
frColor,
frEmail,
frIpAddress,
frUserName,
frFullName,
frFirstName,
frLastName,
frCountry,
frAddress,
frDate,
frCreditCard,
frElement,
frBoolean,
} from "@ethico/fakerandom";
console.log(frColor()); // Output : Green
or You can use it in this way :
import fr from "@ethico/fakerandom";
console.log(fr.frColor()); // Output : red
frInt(options)
Generates a random integer within the specified range.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
min |
number | 0 | optional | The minimum value (including itself). |
max |
number | 100 | optional | The maximum value (including itself). |
example :
import { frInt } from "@ethico/fakerandom";
console.log(frInt()); // Output: 7
console.log(frInt({ min: 22 })); // Output: 26
console.log(frInt({ max: 16 })); // Output: 13
console.log(frInt({ min: 3, max: 9 })); // Output: 5
frFloat(options)
Generates a random floating-point number within the specified range.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
min |
number | 0 | optional | The minimum value (including itself). |
max |
number | 1.0 | optional | The maximum value (including itself). |
precision |
number | 4 | optional | The number of decimal places. |
example :
import { frFloat } from "@ethico/fakerandom";
console.log(frFloat()); // Output: 7.3433
console.log(frFloat({ min: 3, max: 9 })); // Output: 5.3343
frPhone(options)
Generates a random phone number.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
digit |
number | 10 | optional | The number of digits in the phone number without country code. |
countryCode |
string | "+880" | optional | The country code for the phone number. |
example :
import { frPhone } from "@ethico/fakerandom";
console.log(frPhone()); // Output: +8802312345467
console.log(frPhone({ digit: 4 })); // Output: +8802645
console.log(frPhone({ digit: 4, countryCode: +99 })); // Output: +991423
frColor(code)
Generates a random color.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
code |
string | "color" | optional | The color code format to generate. Possible values are "color" (name), "rgb", and "hex". |
example :
import { frColor } from "@ethico/fakerandom";
console.log(frColor()); // Output: red
console.log(frColor("color")); // Output: red
console.log(frColor("rgb")); // Output: rgb(0, 0, 255)
console.log(frColor("hex")); // Output: #66FF00
frEmail(options)
Generates a random email address.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
name |
string | A random fullname | optional | The name to be used in the email address. |
domain |
string | Random domain | optional | The email domain. |
example :
import { frEmail } from "@ethico/fakerandom";
console.log(frEmail());
// Output: AlexBrown@gmail.com
console.log(frEmail({ name: "Alice Bob" }));
// Output: Alice.bob.123@hotmail.com
console.log(frEmail({ name: "Alice Bob", domain: "@abc.org" }));
// Output: Alice.bob.453@abc.org
frIpAddress()
example :
import { frIpAddress } from "@ethico/fakerandom";
console.log(frIpAddress()); // Output: 234.54.6.231
frUserName(name)
Generates a random username. Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
name |
string | A random fullname | optional | The name to be used in the email address. |
example :
import { frUserName } from "@ethico/fakerandom";
console.log(frUserName()); // Output: Alexbrown231
console.log(frUserName({ name: "Alice Bob" })); // Output: alice.bob.123
frFullName(gender)
Generates a random full name.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
gender |
string | "male" | optional | The gender of the person. Possible values are "male" and "female". |
example :
import { frFullName } from "@ethico/fakerandom";
console.log(frFullName()); // Output: Alex brown
console.log(frFullName("male")); // Output: Alen Brulord
console.log(frFullName("female")); // Output: Alice Benian
frFirstName(gender)
Generates a random first name.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
gender |
string | "male" | optional | The gender of the person. Possible values are "male" and "female". |
example :
import { frFirstName } from "@ethico/fakerandom";
console.log(frFirstName()); // Output: Alex
console.log(frFirstName("female")); // Output: Alice
frLastName(gender)
Generates a random last name.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
gender |
string | "male" | optional | The gender of the person. Possible values are "male" and "female". |
example :
import { frLastName } from "@ethico/fakerandom";
console.log(frLastName()); // Output: Brown
console.log(frLastName("female")); // Output: Brunian
frCountry(firstLetter)
Generates a random country name.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
prefix |
string | "" | optional | The prefix of the country name. If provided, the generated country name will start with this letter. |
example :
import { frCountry } from "@ethico/fakerandom";
console.log(frCountry()); // Output: Bangladesh
console.log(frCountry("Ne")); // Output: Nepal
console.log(frCountry("Can")); // Output: Canada
frAddress()
Generates a random address with block, street, city.
example :
import { frAddress } from "@ethico/fakerandom";
console.log(frAddress()); // Output: 27/B,Madison Ave.,Shenzhen
frDate(options)
Generates a random date within next 100 years or previous 100 years.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
type |
string | "future" | optional | The type of date to generate. Possible values are "future", "past", and "any". |
separator |
string | "/" | optional | The separator character to use between day, month, and year. |
example :
import { frDate } from "@ethico/fakerandom";
console.log(frDate()); // Output: 24/08/2023
console.log(frDate({ type: "past" })); // Output: 24/08/2000
console.log(frDate({ type: "future", seperator: "-" })); // Output: 24-08-2025
frCreditCard(options)
Generates a random credit card number.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
cardType |
string | "Visa" | optional | The type of credit card to generate. Possible values are "Visa", "Mastercard", "American Express", and "Discover". |
example :
import { frCreditCard } from "@ethico/fakerandom";
console.log(frCreditCard()); // Output: 4200472352850769|01|2024|937
console.log(frCreditCard({ cardType: "American Express" })); // Output: 3779592616065|10|2024|722
frElement(array)
Selects a random element from the provided array.
Options: An optional object with the following properties:
props | type | default | required | comment |
---|---|---|---|---|
array |
string | [0] | optional | The array from which to select a random element. |
example :
import { frElement } from "@ethico/fakerandom";
console.log(frElement()); // Output: 0
console.log(frElement([1, 2, 3, 4, 5, 6])); // Output: 4
frBoolean()
Generates a random boolean value (true or false).
example :
import { frBoolean } from "@ethico/fakerandom";
console.log(frBoolean()); // Output: true
console.log(frBoolean()); // Output: false
License
This project is licensed under the MIT License. See the License file for details.
Contributing
Contributions are welcome! Contact the author for contribution
Contact
For any inquiries or feedback, please reach out to Shariar Hasan at shahriar.hasan.1523@gmail.com.