Please replace your faker
dependency with @faker-js/faker
. This is the official, stable fork of Faker.
npm install @faker-js/faker --save-dev
or yarn
yarn add @faker-js/faker -D
or pnpm
pnpm install @faker-js/faker -D
<script src="faker.js" type="text/javascript"></script>
<script>
const randomName = faker.name.findName(); // Caitlyn Kerluke
const randomEmail = faker.internet.email(); // Rusty@arne.info
const randomCard = faker.helpers.createCard(); // random contact card containing many properties
</script>
const faker = require('@faker-js/faker');
const randomName = faker.name.findName(); // Rowan Nikolaus
const randomEmail = faker.internet.email(); // Kassandra.Haley@erich.biz
const randomCard = faker.helpers.createCard(); // random contact card containing many properties
Types are available via the @types/faker
package. You must manually link them using a *.d.ts
file, like so:
// faker.d.ts
declare module '@faker-js/faker' {
import faker from 'faker';
export default faker;
}
An in-depth overview of the API methods is available in the documentation. The API covers the following modules:
Faker provides many useful utility functions.
-
faker.address
API Description zipCode Get fake zip code zipCodeByState Get fake zip code by state city Get fake city cityPrefix Get fake city prefix citySuffix Get fake city suffix cityName Get fake city name streetName Get fake street name streetAddress Get fake street address streetSuffix Get fake street suffix streetPrefix Get fake street prefix secondaryAddress Get fake secondary address county Get fake county country Get fake country countryCode Get fake country code state Get fake state stateAbbr Get fake state abbreviation latitude Get fake latitude longitude Get fake longitude direction Get fake direction cardinalDirection Get fake cardinal direction ordinalDirection Get fake ordinal direction nearbyGPSCoordinate Get fake near by gps coordinate timeZone Get fake timezone -
faker.animal
API Description dog Get fake dog type cat Get fake cat type snake Get fake snake type bear Get fake bear type lion Get fake lion type cetacean Get fake cetacean type horse Get fake horse type bird Get fake bird type cow Get fake cow type fish Get fake fish type crocodilia Get fake crocodilia type insect Get fake insect type rabbit Get fake rabbit type -
faker.commerce
API Description color Get fake color name department Get fake department name productName Get fake product name price Get fake price count productAdjective Get fake product adjective productMaterial Get fake product material data product Get fake product name productDescription Get fake product description -
faker.company
API Description suffixes Get fake company suffixes companyName Get fake company name companySuffix Get fake company suffix bs Get fake company business services catchPhraseAdjective Get fake product adjective catchPhraseDescriptor Get fake product material data catchPhraseNoun Get fake product name bsAdjective Get fake business services adjective bsBuzz Get fake business services buzz bsNoun Get fake business services noun -
faker.database
API Description column Get fake database column name type Get fake database column datatype collation Get fake database collation engine Get fake database engine -
faker.datatype
API Description number Generates a random number float Generates a random floating number datetime Generates a random datetime string Generates a random string uuid Generates a valid uuid boolean Generates a boolean hexaDecimal Generates a hexadecimal json Generates a valid json object array Generates an array -
faker.date
API Description past Get a date N
years into the pastfuture Get a date N
years into the futurebetween Get a random date between the dates given betweens Get an array of 3 dates ( by default ) of sorted randoms dates between the dates given recent Get a date N
days from the recent pastsoon Get a date N
days into the futuremonth Generates a random value of date month weekday Generates a random value of date weekday -
faker.fake
-
faker.finance
API Description account Generates a random finance account accountName Generates a random finance account name routingNumber Generates a random finance routing number mask Generates a random finance mask template amount Generates a random amount of transaction transactionType Generates a random transaction type currencyCode Generates a random currency code currencyName Generates a random currency name currencySymbol Generates a random currency symbol bitcoinAddress Generates a random bitcoin address litecoinAddress Generates a random litecoin address creditCardNumber Generates a random credit card number creditCardCVV Generates a random credit card CVV ethereumAddress Generates a random ethereum address (ETH address) iban Generates a random IBAN bic Generates a random BIC transactionDescription Generates a random transaction description -
faker.git
API Description branch Generates a random branch with hacker noun and verb commitEntry Generates a random commit entry with git commit message and sha commitMessage Generates a random commit message with hacker noun, adj and verb commitSha Generates a random commit SHA shortSha Generates a random short SHA -
faker.hacker
API Description abbreviation Generates a random hacker abbreviation adjective Generates a random hacker adjective noun Generates a random hacker noun verb Generates a random hacker noun ingverb Generates a random hacker ingverb phrase Generates a random hacker phrase -
faker.helpers
API Description randomize Get a random element from an array slugify Removes unwanted characters from URI string replaceSymbolWithNumber Parses string for a symbol and replace it with a random number from 1-10 replaceSymbols Parses string for symbols (numbers or letters) and replaces them appropriately (# will be replaced with number, ? with letter and * will be replaced with number or letter) replaceCreditCardSymbols Replace symbols in a credit card schems including Luhn checksum repeatString String repeat helper, alternative to String.prototype.repeat shuffle Takes an array and randomizes it in place then returns it uses the modern version of the Fisher–Yates algorithm mustache Generates a string with mustache {{ }} createCard Generates a human card contextualCard Generates a human contextual card userCard Generates a website user card createTransaction Generates a transaction -
faker.image
API Description image Generates a random image avatar Generates a random avatar imageUrl Generates a random image url abstract Generates a random abstract image animals Generates a random animals image business Generates a random business image cats Generates a random cats image city Generates a random city image food Generates a random food image nightlife Generates a random nightlife image fashion Generates a random fashion image people Generates a random people image nature Generates a random nature image sports Generates a random sports image technics Generates a random technics image transport Generates a random transport image dataUri Generates a random data uri lorempixel Generates a random image url from lorempixel unsplash Generates a random image url from unsplash lorempicsum Generates a random image url from lorem picsum -
faker.internet
API Description avatar Generates a random avatar email Generates a random email exampleEmail Generates a random example email userName Generates a random user name protocol Generates a random internet protocol (http or https) httpMethod Generates a random http method url Generates a random url domainName Generates a random domain name domainSuffix Generates a random domain suffix domainWord Generates a random domain word ip Generates a random ip ipv6 Generates a random ipv6 port Generates a random port number userAgent Generates a random user agent color Generates a random hexadecimal color mac Generates a random mac address password Generates a random password -
faker.lorem
API Description word Generates a random lorem word words Generates a random lorem words sentence Generates a random lorem sentence slug Generates a random lorem slug sentences Generates a random lorem sentences paragraph Generates a random lorem paragraph paragraphs Generates a random lorem paragraphs text Generates a random lorem text lines Generates a random lorem lines -
faker.mersenne
API Description rand Generates a random mersenne rand seed Generates a random mersenne seed seed_array Generates a random datetime seed init by array -
faker.music
API Description genre Generates a random music genre -
faker.name
API Description firstName Generates a random human first name lastName Generates a random human last name middleName Generates a random human middle name findName Generates a random human first name and last name jobTitle Generates a random human job title, combination of jobDescriptor, jobArea and jobType gender Generates a random gender prefix Generates a random locale with gender specific name prefix suffix Generates a random locale with gender specific name suffix title Generates a random human title jobDescriptor Generates a random human job descriptor jobArea Generates a random human job area jobType Generates a random human job type -
faker.phone
API Description phoneNumber Generates a random phone number phoneNumberFormat Generates a random phone number with requested format (Array index) phoneFormats Generates a random phone number format -
faker.system
API Description fileName Generates a random filenames without system path separators commonFileName Generates a random filenames without system path separators mimeType Generates a random mimetypes commonFileType Generates a random commonly used file type commonFileExt Generates a random commonly used file extension fileType Get any file type available as mime-type fileExt Generates a random file extension directoryPath Generates a random directory path filePath Generates a random unix fs file full path semver Generate semantic version -
faker.time
API Description recent Get recent timestamp in Unix time format -
faker.unique
-
faker.vehicle
API Description vehicle Generates a random vehicle name manufacturer Generates a random vehicle manufacturer name model Generates a random vehicle model name type Generates a random vehicle type fuel Generates a random vehicle fuel type vin Generates a random vehicle vin number color Generates a random vehicle color vrm Generates a random vehicle vrm bicycle Generates a random bicycle type
Faker contains a super useful generator method Faker.fake
for combining faker API methods using a mustache string format.
Example:
console.log(
faker.fake('{{name.lastName}}, {{name.firstName}} {{name.suffix}}')
);
This will interpolate the format string with the value of methods name.lastName()
, name.firstName()
, and name.suffix()
Faker has support for multiple locales.
The default language locale is set to English.
Setting a new locale is simple:
// sets locale to de
faker.locale = 'de';
List of locales: az, ar, cz, de, de_AT, de_CH, en, en_AU, en_AU_ocker, en_BORK, en_CA, en_GB, en_IE, en_IND, en_US, en_ZA, es, es_MX, fa, fi, fr, fr_CA, fr_CH, ge, hy, hr, id_ID, it, ja, ko, nb_NO, ne, nl, nl_BE, pl, pt_BR, pt_PT, ro, ru, sk, sv, tr, uk, vi, zh_CN, zh_TW
Faker supports incremental loading of locales.
// loads only de locale
const faker = require('@faker-js/faker/locale/de');
If you want consistent results, you can set your own seed:
faker.seed(123);
const firstRandom = faker.datatype.number();
// Setting the seed again resets the sequence.
faker.seed(123);
const secondRandom = faker.datatype.number();
console.log(firstRandom === secondRandom);
Faker uses gulp to automate its build process. Each build operation is a separate task which can be run independently.
pnpm install
pnpm run build
pnpm run browser
pnpm install
pnpm run build
pnpm run test
# or
pnpm run coverage
You can view a code coverage report generated in coverage/index.html
.
# build the Faker library for the browser
# it's used inside of certain routes
pnpm run browser
pnpm run docs:dev
# build the Faker library for the browser
# it's used inside of certain routes
pnpm run browser
pnpm run docs:build # Output docs to /dist
pnpm run docs:serve # Serve docs from /dist
The website is kindly hosted for free by the Netlify team under their Open Source plan. See the netlify.toml for configuration.
Read the team update (January 14th, 2022).