From 2ad1187499b52cb6964d0d2e8cd590e6c3196772 Mon Sep 17 00:00:00 2001 From: Fauzan Date: Thu, 20 Jan 2022 01:32:41 +0700 Subject: [PATCH] docs(readme.md): api methods table with description (#160) Co-authored-by: Eric Cheng --- README.md | 332 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 330 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 0e7f982f7bb..ee48e1edf3e 100644 --- a/README.md +++ b/README.md @@ -64,6 +64,7 @@ declare module '@faker-js/faker' { ## API An in-depth overview of the API methods is available in the documentation. The API covers the following modules: + | Module | Example | Output | |---------- |-------------------------------- |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Address | `faker.address.city()` | Lake Raoulfort | @@ -84,9 +85,336 @@ An in-depth overview of the API methods is available in the documentation. The A | Name | `faker.name.firstName()` | Cameron | | Phone | `faker.phone.phoneNumber()` | +1 291-299-0192 | | System | `faker.system.directoryPath()` | C:\Documents\Newsletters\ | -| Vehicle | `faker.vehicle.vehicle()` | 2011 Dodge Caravan | +| Vehicle | `faker.vehicle.vehicle()` | 2011 Dodge Caravan + +### API Methods + +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 past | + | future | Get a date `N` years into the future | + | between | 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 past | + | soon | Get a date `N` days into the future | + | month | 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.fake() + +Faker contains a super useful generator method `Faker.fake` for combining faker API methods using a mustache string format. + +**Example:** + +```js +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()` -### Localization +## Localization Faker has support for multiple locales.