@ethico/fakerandom

2.1.0 • Public • Published

@ethico/fakerandom

npm version License

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.

Readme

Keywords

none

Package Sidebar

Install

npm i @ethico/fakerandom

Weekly Downloads

0

Version

2.1.0

License

ISC

Unpacked Size

49.8 kB

Total Files

19

Last publish

Collaborators

  • ethico