This npm package enables you to quickly and easily make variety of random mock data for testing your applications or any other similar purpose. It is very flexible and you can produce a whole lot of mock data with just a single line of code.
npm install randomize-everythingThis package's functionalities can be broken in several sections, from the most basic usage to more complex applications:
Basics: provides basic randomization like random numbers or booleansGenerals: provides random data from lists in many categoriesDerivatives: provides random data derived from basic onesBundles: provides final objects with prepared properties and random data for each one of themStructures: provides ability to make your own structures like arrays or objects with random data as values
Every function this package provides can accept several parameters which have a common meaning for each one of them. You can omit them but if you pass those arguments, they have a specific meaning:
count: repeats randomization count times and makes an array instead of returning a single valueprop: makes an object out of the randomization result and provided prop will be its property name
-
getRandomNumber: produces random number between min and max, array of random numbers or an object, depending on passed argumentsparameters: min, max, decimals, count, propreturns: number, array or object
-
getRandomBoolean: produces random boolean value, array of random boolean values or an object, depending on passed argumentsparameters: count, propreturns: boolean, array or object
Every function in Generals section accepts arguments count and prop which are optional so they are not shown here for easier readability.
getRandom(lists.actors): returns random actor, array of actors or an object depending on passed argumentsgetRandom(lists.animals): returns random animal, array of animals or an object depending on passed argumentsgetRandom(lists.artists): returns random artist, array of artists or an object depending on passed argumentsgetRandom(lists.bands): returns random band, array of bands or an object depending on passed argumentsgetRandom(lists.books): returns random book, array of books or an object depending on passed argumentsgetRandom(lists.browsers): returns random browser, array of browsers or an object depending on passed argumentsgetRandom(lists.cars): returns random car, array of cars or an object depending on passed argumentsgetRandom(lists.cats): returns random cat, array of cats or an object depending on passed argumentsgetRandom(lists.chemicalElements): returns random chemical element, array of chemical elements or an object depending on passed argumentsgetRandom(lists.chessPlayers): returns random chess player, array of chess players or an object depending on passed argumentsgetRandom(lists.cities): returns random city, array of cities or an object depending on passed argumentsgetRandom(lists.colors): returns random color, array of colors or an object depending on passed argumentsgetRandom(lists.continents): returns random continent, array of continents or an object depending on passed argumentsgetRandom(lists.countries): returns random country, array of countries or an object depending on passed argumentsgetRandom(lists.cryptoCurrencies): returns random cryptocurrency, array of cryptocurrencies or an object depending on passed argumentsgetRandom(lists.currencies): returns random currency, array of currencies or an object depending on passed argumentsgetRandom(lists.daysOfWeek): returns random day of week, array of days of week or an object depending on passed argumentsgetRandom(lists.dinosaurs): returns random dinosaur, array of dinosaurs or an object depending on passed argumentsgetRandom(lists.dogs): returns random dog, array of dogs or an object depending on passed argumentsgetRandom(lists.extensions): returns random dog, array of dogs or an object depending on passed argumentsgetRandom(lists.firstNames): returns random first name, array of first names or an object depending on passed argumentsgetRandom(lists.foodCategories): returns random food category, array of food categories or an object depending on passed argumentsgetRandom(lists.fruits): returns random fruit, array of fruits or an object depending on passed argumentsgetRandom(lists.genders): returns random gender, array of genders or an object depending on passed argumentsgetRandom(lists.hobbies): returns random hobby, array of hobbies or an object depending on passed argumentsgetRandom(lists.ingredients): returns random ingredient, array of ingredients or an object depending on passed argumentsgetRandom(lists.instruments): returns random instrument, array of instruments or an object depending on passed argumentsgetRandom(lists.itJobTitles): returns random IT job title, array of IT job titles or an object depending on passed argumentsgetRandom(lists.itemConditions): returns random item condition, array of item conditions or an object depending on passed argumentsgetRandom(lists.jobCategories): returns random job category, array of job categories or an object depending on passed argumentsgetRandom(lists.languages): returns random language, array of languages or an object depending on passed argumentsgetRandom(lists.lastNames): returns random last name, array of last names or an object depending on passed argumentsgetRandom(lists.letters): returns random letter, array of letters or an object depending on passed argumentsgetRandom(lists.mobilePhones): returns random mobile phone, array of mobile phones or an object depending on passed argumentsgetRandom(lists.monthsOfYear): returns random month, array of months or an object depending on passed argumentsgetRandom(lists.motorcycles): returns random motorcycle, array of motorcycles or an object depending on passed argumentsgetRandom(lists.mountains): returns random mountain, array of mountains or an object depending on passed argumentsgetRandom(lists.movieGenres): returns random movie genre, array of movie genres or an object depending on passed argumentsgetRandom(lists.movies): returns random movie, array of movies or an object depending on passed argumentsgetRandom(lists.musicGenres): returns random music genre, array of music genres or an object depending on passed argumentsgetRandom(lists.oceans): returns random oceans, array of oceans or an object depending on passed argumentsgetRandom(lists.os): returns random operating system, array of operating systems or an object depending on passed argumentsgetRandom(lists.painters): returns random painter, array of painters or an object depending on passed argumentsgetRandom(lists.paintings): returns random paining, array of paintings or an object depending on passed argumentsgetRandom(lists.philosophers): returns random philosopher, array of philosopher or an object depending on passed argumentsgetRandom(lists.planets): returns random planet, array of planets or an object depending on passed argumentsgetRandom(lists.programmingLanguages): returns random programming language, array of programming languages or an object depending on passed argumentsgetRandom(lists.quotesLatin): returns random Latin quote, array of Latin quotes or an object depending on passed argumentsgetRandom(lists.religions): returns random religion, array of religions or an object depending on passed argumentsgetRandom(lists.schoolGradesLettered): returns random lettered school grade, array of school grades or an object depending on passed argumentsgetRandom(lists.schoolGradesNumbered): returns random numbered school grade, array of school grades or an object depending on passed argumentsgetRandom(lists.schoolSubjects): returns random school subject, array of school subjects or an object depending on passed argumentsgetRandom(lists.scientists): returns random scientist, array of scientists or an object depending on passed argumentsgetRandom(lists.seasons): returns random season, array of seasons or an object depending on passed argumentsgetRandom(lists.sizes): returns random size, array of sizes or an object depending on passed argumentsgetRandom(lists.skillLevels): returns random skill level, array of skill levels or an object depending on passed argumentsgetRandom(lists.soccerTeams): returns random soccer team, array of soccer teams or an object depending on passed argumentsgetRandom(lists.socialMedia): returns random social media, array of social media or an object depending on passed argumentsgetRandom(lists.sportists): returns random sportist, array of sportists or an object depending on passed argumentsgetRandom(lists.sports): returns random sport, array of sports or an object depending on passed argumentsgetRandom(lists.todos): returns random todo, array of todos or an object depending on passed argumentsgetRandom(lists.tools): returns random tool, array of tools or an object depending on passed argumentsgetRandom(lists.vegetables): returns random vegetable, array of vegetables or an object depending on passed argumentsgetRandom(lists.vehicles): returns random vehicle, array of vehicles or an object depending on passed argumentsgetRandom(lists.words): returns random word, array of words or an object depending on passed argumentsgetRandom(lists.writers): returns random writer, array of writers or an object depending on passed argumentsgetRandom(lists.zodiacSigns): returns random zodiac sign, array of zodiac signs or an object depending on passed arguments
Every function in Derivatives section accepts arguments count and prop which are optional so they are not shown here for easier readability.
getRandomCreditCardNumber(): returns random credit card number, array of credit card numbers or an object depending on passed argumentsgetRandomDate(): returns random date, array of dates or an object depending on passed argumentsgetRandomDateTime(): returns random date and time, array of dates and times or an object depending on passed argumentsgetRandomEmail(): returns random e-mail, array of e-mails or an object depending on passed argumentsgetRandomFilename(): returns random file name, array of file names or an object depending on passed argumentsgetRandomFullName(): returns random full name, array of full names or an object depending on passed argumentsgetRandomFullAddress(): returns random full address, array of full addresses or an object depending on passed argumentsgetRandomGoogleMapsCoordinates(): returns random Google Maps coordinates (lat, lng), array of Google Maps coordinates or an object depending on passed argumentsgetRandomIpAddress(): returns random IP address, array of IP addresses or an object depending on passed argumentsgetRandomPhoneNumber(): returns random phone number, array of phone numbers or an object depending on passed argumentsgetRandomStreet(): returns random street, array of streets or an object depending on passed argumentsgetRandomStreetNumber(): returns random street with number, array of streets with numbers or an object depending on passed argumentsgetRandomStreetNumberCity(): returns random street with number and city, array of streets with numbers and city or an object depending on passed argumentsgetRandomTime(): returns random time, array of times or an object depending on passed argumentsgetRandomUrl(): returns random URL, array of URLs or an object depending on passed arguments
getRandomUser(2, "users"): returns two objects in an array with predefined properties suitable for some users data as a users objectgetRandomStudent(4, "students"): returns four objects in an array with predefined properties suitable for some students data as a students objectgetRandomTodo(10, "todos"): returns ten objects in an array with predefined properties suitable for some todo data as a todos objectgetRandomCrypto(3, "cryptos"): returns three objects in an array with predefined properties suitable for some crypto data as a cryptos object
Unlike previous functionalities which work with predefined data and lists, Structures enable us to create more complex arrays and objects of our own liking and needs. Its usage may seem a little complicated but they are used just like any of the previous functions. The only difference is that this time we prepare values to be randomized as strings and those strings have to start with "func:". All object properties also have to be stringified, just like JSON.stringify() would do. If we are careful with preparation (i. e. stringification), we can create very complex arrays and nested objects with random data. More on that in Usage and Examples.
-
getRandomObject: returns array or object of our own structureparameters: str, count, propreturns: array or object
Declare the package and use its functions with appropriate parameters, like so:
const re = require("randomize-everything");
// Basics
console.log(re.basics().getRandomBoolean(1, "isadmin"));
console.log(re.basics().getRandomNumber(10, 100, 2, 1, ""));
// Generals
console.log(re.generals().getRandom(re.lists.actors));
console.log(re.generals().getRandom(re.lists.animals));
console.log(re.generals().getRandom(re.lists.artists));
console.log(re.generals().getRandom(re.lists.bands));
console.log(re.generals().getRandom(re.lists.books));
console.log(re.generals().getRandom(re.lists.browsers));
console.log(re.generals().getRandom(re.lists.cars));
console.log(re.generals().getRandom(re.lists.cats));
console.log(re.generals().getRandom(re.lists.chemicalElements));
console.log(re.generals().getRandom(re.lists.chessPlayers));
console.log(re.generals().getRandom(re.lists.cities));
console.log(re.generals().getRandom(re.lists.colors));
console.log(re.generals().getRandom(re.lists.continents));
console.log(re.generals().getRandom(re.lists.countries));
console.log(re.generals().getRandom(re.lists.cryptoCurrencies));
console.log(re.generals().getRandom(re.lists.currencies));
console.log(re.generals().getRandom(re.lists.daysOfWeek));
console.log(re.generals().getRandom(re.lists.dinosaurs));
console.log(re.generals().getRandom(re.lists.dogs));
console.log(re.generals().getRandom(re.lists.extensions));
console.log(re.generals().getRandom(re.lists.firstNames));
console.log(re.generals().getRandom(re.lists.foodCategories));
console.log(re.generals().getRandom(re.lists.fruits));
console.log(re.generals().getRandom(re.lists.genders));
console.log(re.generals().getRandom(re.lists.hobbies));
console.log(re.generals().getRandom(re.lists.ingredients));
console.log(re.generals().getRandom(re.lists.instruments));
console.log(re.generals().getRandom(re.lists.itJobTitles));
console.log(re.generals().getRandom(re.lists.itemConditions));
console.log(re.generals().getRandom(re.lists.jobCategories));
console.log(re.generals().getRandom(re.lists.languages));
console.log(re.generals().getRandom(re.lists.lastNames));
console.log(re.generals().getRandom(re.lists.letters));
console.log(re.generals().getRandom(re.lists.mobilePhones));
console.log(re.generals().getRandom(re.lists.monthsOfYear));
console.log(re.generals().getRandom(re.lists.motorcycles));
console.log(re.generals().getRandom(re.lists.mountains));
console.log(re.generals().getRandom(re.lists.movieGenres));
console.log(re.generals().getRandom(re.lists.movies));
console.log(re.generals().getRandom(re.lists.musicGenres));
console.log(re.generals().getRandom(re.lists.oceans));
console.log(re.generals().getRandom(re.lists.os));
console.log(re.generals().getRandom(re.lists.painters));
console.log(re.generals().getRandom(re.lists.paintings));
console.log(re.generals().getRandom(re.lists.philosopher));
console.log(re.generals().getRandom(re.lists.planets));
console.log(re.generals().getRandom(re.lists.programmingLanguages));
console.log(re.generals().getRandom(re.lists.quotesLatin));
console.log(re.generals().getRandom(re.lists.religions));
console.log(re.generals().getRandom(re.lists.schoolGradesLettered));
console.log(re.generals().getRandom(re.lists.schoolGradesNumbered));
console.log(re.generals().getRandom(re.lists.schoolSubjects));
console.log(re.generals().getRandom(re.lists.scientists));
console.log(re.generals().getRandom(re.lists.seasons));
console.log(re.generals().getRandom(re.lists.sizes));
console.log(re.generals().getRandom(re.lists.skillLevels));
console.log(re.generals().getRandom(re.lists.soccerTeams));
console.log(re.generals().getRandom(re.lists.socialMedia));
console.log(re.generals().getRandom(re.lists.sportists));
console.log(re.generals().getRandom(re.lists.sports));
console.log(re.generals().getRandom(re.lists.todos));
console.log(re.generals().getRandom(re.lists.tools));
console.log(re.generals().getRandom(re.lists.vegetables));
console.log(re.generals().getRandom(re.lists.vehicles));
console.log(re.generals().getRandom(re.lists.words));
console.log(re.generals().getRandom(re.lists.writers));
console.log(re.generals().getRandom(re.lists.zodiacSigns));
// Derivatives
console.log(re.derivatives().getRandomCreditCardNumber());
console.log(re.derivatives().getRandomDate());
console.log(re.derivatives().getRandomDateTime());
console.log(re.derivatives().getRandomEmail());
console.log(re.derivatives().getRandomFilename());
console.log(re.derivatives().getRandomFullName());
console.log(re.derivatives().getRandomFullAddress());
console.log(re.derivatives().getRandomGoogleMapsCoordinates());
console.log(re.derivatives().getRandomIpAddress());
console.log(re.derivatives().getRandomPhoneNumber());
console.log(re.derivatives().getRandomStreet());
console.log(re.derivatives().getRandomStreetNumber());
console.log(re.derivatives().getRandomStreetNumberCity());
console.log(re.derivatives().getRandomTime());
console.log(re.derivatives().getRandomUrl());
// Bundles
console.log(re.bundles().getRandomUser(2, "users"));
console.log(re.bundles().getRandomStudent(2, "students"));
console.log(re.bundles().getRandomTodo(2, "todos"));
console.log(re.bundles().getRandomCrypto(2, "cryptos"));
// Structures
let str = `
{
"fullname": "func:derivatives().getRandomFullName()",
"address": "func:derivatives().getRandomFullAddress()",
"location": "func:derivatives().getRandomGoogleMapsCoordinates()"
}
`;
console.log(re.structures().getRandomObject(str, 2, "data"));console.log(re.basics().getRandomBoolean());
// true
console.log(re.basics().getRandomBoolean(3));
// [ true, false, true ]
console.log(re.basics().getRandomBoolean(1, "isadmin"));
// { isadmin: false }
console.log(re.basics().getRandomBoolean(2, "isadmin"));
// { isadmin: [ true, false ] }
console.log(re.basics().getRandomNumber(1, 10));
// 7
console.log(re.basics().getRandomNumber(10, 100, 2));
// 57.32
console.log(re.basics().getRandomNumber(10, 100, 2, 3));
// [ 91.14, 93.07, 52.8 ]
console.log(re.basics().getRandomNumber(10, 100, 2, 3, ""));
// [ 91.14, 93.07, 52.8 ]
console.log(re.basics().getRandomNumber(10, 100, 0, 1, "num"));
// { num: 80 }
console.log(re.basics().getRandomNumber(10, 100, 2, 3, "num"));
// { num: [ 49.07, 80.46, 69.22 ] }console.log(re.generals().getRandom(re.lists.actors));
// Sean Connery
console.log(re.generals().getRandom(re.lists.actors, 3));
// [ 'Megan Fox', 'Robert De Niro', 'Ian McKellen' ]
console.log(re.generals().getRandom(re.lists.actors, 1, "actor"));
// { actor: 'Nicolas Cage' }
console.log(re.generals().getRandom(re.lists.actors, 3, "actors"));
// { actors: [ 'Catherine Zeta - Jones', 'Nicolas Cage', 'Vin Diesel' ] }console.log(re.derivatives().getRandomPhoneNumber());
// +152 (40) 9686 232
console.log(re.derivatives().getRandomPhoneNumber(2));
// [ '+145 (11) 7739 402', '+777 (59) 4752 783' ]
console.log(re.derivatives().getRandomPhoneNumber(1, "phone"));
// { phone: '+926 (58) 1163 301' }
console.log(re.derivatives().getRandomPhoneNumber(3, "phones"));
// { phones: [ '+506 (42) 4274 918', '+316 (11) 2468 291', '+647 (47) 1706 175' ] }console.log(re.bundles().getRandomUser());
// {
// users: {
// firstname: 'Douglas',
// lastname: 'Mitchell',
// phone: '+760 (91) 4949 238',
// email: 'douglas.mitchell@example.com',
// address: { street: 'Taylor Street', number: 986, city: 'Tbilisi' },
// occupation: 'Network engineer',
// hobbies: [ 'Crosswords', 'Card games', 'Photography', 'Chess' ],
// languages: [ 'Icelandic', 'Uzbek', 'Italian' ],
// isregistered: true,
// visited: [
// 'Malawi',
// 'Uruguay',
// 'Seychelles',
// 'Gabon',
// 'El Salvador',
// 'Andorra',
// 'Cuba',
// 'Palau'
// ]
// }
// }
console.log(re.bundles().getRandomStudent(2, "students"));
// {
// students: [
// {
// firstname: 'Alan',
// lastname: 'Johnson',
// mainSubject: 'Pre - algebra',
// otherSubjects: [Array],
// favouriteWriters: [Array],
// hasgraduated: false
// },
// {
// firstname: 'Beverly',
// lastname: 'Torres',
// mainSubject: 'Algebra',
// otherSubjects: [Array],
// favouriteWriters: [Array],
// hasgraduated: true
// }
// ]
// }
console.log(re.bundles().getRandomTodo(2, "todos"));
// {
// todos: [
// {
// subject: 'Find lost keys',
// created: '2003-04-20 16:23:35',
// others: [Array],
// completed: true
// },
// {
// subject: 'Brush teeth',
// created: '2006-12-30 15:49:37',
// others: [Array],
// completed: true
// }
// ]
// }
console.log(re.bundles().getRandomCrypto(3, "cryptos"));
// {
// cryptos: [
// { asset_id: 'DOT', name: 'Polkadot', price_usd: 4599.7865855206 },
// { asset_id: 'ETH', name: 'Ethereum', price_usd: 7048.8463438487 },
// { asset_id: 'DAI', name: 'Dai', price_usd: 5130.0346719575 }
// ]
// }let str = `
{
"fullname": "func:derivatives().getRandomFullName()",
"address": "func:derivatives().getRandomFullAddress()",
"location": "func:derivatives().getRandomGoogleMapsCoordinates()"
}
`;
console.log(re.structures().getRandomObject(str, 2, "data"));
// {
// "data": [
// {
// "fullname": "Philip Gonzalez",
// "address": {
// "street": "Baker Square",
// "number": 211,
// "city": "Kampala"
// },
// "location": {
// "lat": 57.87272,
// "lng": 46.46332
// }
// },
// {
// "fullname": "Carolyn Moore",
// "address": {
// "street": "Johnson Street",
// "number": 63,
// "city": "Bishkek"
// },
// "location": {
// "lat": -3.67129,
// "lng": 100.71773
// }
// }
// ]
// }Let's say we would now like to add some more custom data to our previous object. We want to add to each person an array of courses taken by that person with some details about each course (that would be an array of objects). Let's add three courses for each person:
let strCourses = `
{
"course": "func:generals().getRandom(lists.schoolSubjects)",
"started": "func:derivatives().getRandomDate()",
"completed": "func:basics().getRandomBoolean()"
}
`;
let str = `
{
"fullname": "func:derivatives().getRandomFullName()",
"address": "func:derivatives().getRandomFullAddress()",
"location": "func:derivatives().getRandomGoogleMapsCoordinates()",
"courses": [${strCourses}, ${strCourses}, ${strCourses}]
}
`;
console.log(re.structures().getRandomObject(str, 2, "data"));
// {
// "data": [
// {
// "fullname": "Bruce Hall",
// "address": {
// "street": "Mitchell Street",
// "number": 24,
// "city": "Kuwait City"
// },
// "location": {
// "lat": -17.98289,
// "lng": -42.51945
// },
// "courses": [
// {
// "course": "Earth Science",
// "started": "2017-10-10",
// "completed": true
// },
// {
// "course": "Basic Math",
// "started": "2011-09-01",
// "completed": true
// },
// {
// "course": "Ancient Civilizations",
// "started": "2016-06-26",
// "completed": true
// }
// ]
// },
// {
// "fullname": "Cynthia Sanchez",
// "address": {
// "street": "Lopez Square",
// "number": 304,
// "city": "N'Djamena"
// },
// "location": {
// "lat": 88.36883,
// "lng": 132.76602
// },
// "courses": [
// {
// "course": "Basic Math",
// "started": "2020-03-26",
// "completed": false
// },
// {
// "course": "Instrumental Music",
// "started": "2024-12-26",
// "completed": true
// },
// {
// "course": "Honors Math in Algebra or Geometry",
// "started": "2013-04-18",
// "completed": true
// }
// ]
// }
// ]
// }Instead of an array we also could have added a nested object the same way. Possibilities are endless here. As long we are very careful with stringification before calling re.structures().getRandomObject(), we are good to go. Also, don't forget to add the func: prefix for every value to be randomized. If you get an error saying something like "Unexpected token at position XXX", that's the strongest sign that your str argument is not prepared careful enough before passing it to the re.structures().getRandomObject() function.
-
1.0.1
- Added three more functions in Derivatives: getRandomFilename(), getRandomIpAddress(), getRandomUrl()
- Added more lists to choose data randomization from (animals, bands, books, cars, cats, chemical elements, chess players, dinosaurs, dogs, extensions, ingredients, instruments, mobile phones, motorcycles, movies, painters, paintings, philosophers, scientists, seasons, soccer teams, social media, sportists, sports, tools, vehicles)
- Fixed Structures example in README.md file (previous example repeated three same courses for each person). There were no changes in code, just in that last example.
-
1.0.0 - Initial version