{"id":15184566,"url":"https://github.com/rgerhardt-pressmind/constructs-js","last_synced_at":"2026-03-02T19:33:16.861Z","repository":{"id":57206269,"uuid":"447243501","full_name":"RGerhardt-Pressmind/constructs-js","owner":"RGerhardt-Pressmind","description":"A NodeJS based data generator. This returns an infinite amount of randomly generated data according to a structure or inserts it into a database system.","archived":false,"fork":false,"pushed_at":"2022-01-20T15:28:18.000Z","size":820,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-25T01:43:35.966Z","etag":null,"topics":["angular","angular-cli","angular2","angular4","browser","database","fakerjs","generator","javascript","nodejs","template","typescript","unique"],"latest_commit_sha":null,"homepage":"https://rgerhardt-pressmind.github.io/constructs-js/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RGerhardt-Pressmind.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-12T14:12:04.000Z","updated_at":"2022-01-13T16:00:00.000Z","dependencies_parsed_at":"2022-09-11T05:01:47.321Z","dependency_job_id":null,"html_url":"https://github.com/RGerhardt-Pressmind/constructs-js","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RGerhardt-Pressmind%2Fconstructs-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RGerhardt-Pressmind%2Fconstructs-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RGerhardt-Pressmind%2Fconstructs-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RGerhardt-Pressmind%2Fconstructs-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RGerhardt-Pressmind","download_url":"https://codeload.github.com/RGerhardt-Pressmind/constructs-js/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240587544,"owners_count":19825004,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","angular-cli","angular2","angular4","browser","database","fakerjs","generator","javascript","nodejs","template","typescript","unique"],"created_at":"2024-09-27T17:04:55.612Z","updated_at":"2026-03-02T19:33:16.812Z","avatar_url":"https://github.com/RGerhardt-Pressmind.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# constructs.js - creates extremely large amount of random data for browser and node.js\n\n## Demo\n[https://rgerhardt-pressmind.github.io/constructs-js](https://rgerhardt-pressmind.github.io/constructs-js)\n\n[![npm version](https://badge.fury.io/js/constructs-js.svg)](https://www.npmjs.com/package/constructs-js)\n![locales](https://img.shields.io/badge/locales%20available-21-blue)\n\n## Table of contents\n\n- [Demo](#demo)\n- [Introduction](#introduction)\n  * [Browser](#browser)\n  * [NodeJS](#nodejs)\n  * [Angular 2+](#angular-2-)\n  * [locales available](#locales-available)\n- [Usage template](#usage-template)\n  * [Example](#example)\n  * [Output](#output)\n- [API](#api)\n  * [Standalone](#standalone)\n    + [address](#address)\n      - [getAddress](#getaddress)\n      - [getStreet](#getstreet)\n      - [getBuildingNumber](#getbuildingnumber)\n      - [getPostcode](#getpostcode)\n      - [getState](#getstate)\n    + [city](#city)\n      - [getCity](#getcity)\n      - [getPrefix](#getprefix)\n      - [getSuffix](#getsuffix)\n    + [company](#company)\n      - [getCompany](#getcompany)\n      - [getSuffix](#getsuffix-1)\n    + [country](#country)\n      - [getCountry](#getcountry)\n      - [getDefaultCountry](#getdefaultcountry)\n    + [credit_card](#credit_card)\n      - [getNumber](#getNumber)\n      - [getMaestro](#getMaestro)\n      - [getMastercard](#getMastercard)\n      - [getAmex](#getAmex)\n      - [getVisa](#getVisa)\n    + [email](#email)\n      - [getEmail](#getemail)\n      - [getSuffix](#getsuffix-2)\n    + [image](#image)\n      - [getImage](#getimage)\n        * [Animal](#animal)\n        * [Avatar](#avatar)\n        * [City](#city)\n        * [Human](#human)\n        * [Nature](#nature)\n        * [Technic](#technic)\n    + [loremIpsum](#loremipsum)\n      - [getWords](#getwords)\n    + [name](#name)\n      - [getName](#getname)\n      - [getFirstName](#getfirstname)\n      - [getSurName](#getsurname)\n      - [getSalutation](#getsalutation)\n      - [getTitle](#gettitle)\n    + [phone](#phone)\n      - [getCellPhoneNumber](#getcellphonenumber)\n      - [getPhoneNumber](#getphonenumber)\n  * [Template](#template)\n  * [Template masks](#template-masks)\n  * [Module functions](#module-functions)\n    + [Global modules](#global-modules)\n      - [[id]](#id)\n      - [[date]](#date)\n      - [[datetime]](#datetime)\n      - [[diffYearNow]](#diffyearnow)\n    + [address](#address-1)\n      - [[address:getAddress]](#addressgetaddress)\n      - [[address:getStreet]](#addressgetstreet)\n      - [[address:getBuildingNumber]](#addressgetbuildingnumber)\n      - [[address:getPostcode]](#addressgetpostcode)\n      - [[address:getState]](#addressgetstate)\n    + [city](#city-1)\n      - [[city:getCity]](#citygetcity)\n      - [[city:getPrefix]](#citygetprefix)\n      - [[city:getSuffix]](#citygetsuffix)\n    + [company](#company-1)\n      - [[company:getCompany]](#companygetcompany)\n      - [[company:getSuffix]](#companygetsuffix)\n    + [country](#country-1)\n      - [[country:getCountry]](#countrygetcountry)\n      - [[country:getDefaultCountry]](#countrygetdefaultcountry)\n    + [credit_card](#credit_card-1)\n      - [[credit_card:getNumber]](#credit_cardgetnumber)\n      - [[credit_card:getMaestro]](#credit_cardgetmaestro)\n      - [[credit_card:getMastercard]](#credit_cardgetmastercard)\n      - [[credit_card:getAmex]](#credit_cardgetamex)\n      - [[credit_card:getVisa]](#credit_cardgetvisa)\n    + [email](#email-1)\n      - [[email:getEmail]](#emailgetemail)\n      - [[email:getSuffix]](#emailgetsuffix)\n    + [image](#image)\n      - [[image:getImage]](#imagegetimage)\n      - [[image:getAvatarImage]](#imagegetavatarimage)\n      - [[image:getAnimalImage]](#imagegetanimalimage)\n      - [[image:getCityImage]](#imagegetcityimage)\n      - [[image:getHumanImage]](#imagegethumanimage)\n      - [[image:getNatureImage]](#imagegetnatureimage)\n      - [[image:getTechnicImage]](#imagegettechnicimage)\n    + [loremIpsum](#loremipsum-1)\n      - [[loremIpsum:getWords]](#loremipsumgetwords)\n    + [name](#name-1)\n      - [[name:getName]](#namegetname)\n      - [[name:getFirstName]](#namegetfirstname)\n      - [[name:getSurName]](#namegetsurname)\n      - [[name:getSalutation]](#namegetsalutation)\n      - [[name:getTitle]](#namegettitle)\n    + [phone](#phone-1)\n      - [[phone:getPhoneNumber]](#phonegetphonenumber)\n      - [[phone:getCellPhoneNumber]](#phonegetcellphonenumber)\n\n## Introduction\n\n### Browser\n\nDownload [latest stable](https://github.com/RGerhardt-Pressmind/constructs-js/releases/latest) version.\n\n```html\n\u003cscript src = \"dist/constructs.min.js\" type = \"text/javascript\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n    var constructs = new constructs(\"de\"); // de = locale (fallback locale is \"de\")\n\n    let uniqFirstName = constructs.name.getFirstName(); // Maik\n    let uniqSurName   = constructs.name.getSurName(); // Raschel\n    let uniqEmail     = constructs.email.getEmail(); // max@gmail.com\n\u003c/script\u003e\n```\n\n### NodeJS\n\nInstall\n```\nnpm install constructs-js --save\n```\n\nUsage\n\n```javascript\nconst Constructs    =   require('./construct');\nlet construct      =   new Constructs('de'); // de = locale (fallback locale is \"de\")\n\nlet first_name = constructs.name.getFirstName();\nlet sur_name   = constructs.name.getSurName();\nlet email      = constructs.email.getEmail();\n```\n\n### Angular 2+\n\nInstall\n```\nnpm install constructs-js --save\n```\n\nUsage\n\nAdd the constructs.min.js in the angular.json at the scripts block\n```json\n{\n  \"scripts\": [\n    \"node_modules/constructs-js/dist/constructs.min.js\"\n  ]\n}\n```\n\nTest e.g. in the app.component.ts if the script is reachable:\n\n```typescript\n@Component({\n  selector: 'app-root',\n  templateUrl: './app.component.html',\n  styleUrls: ['./app.component.scss']\n})\nexport class AppComponent {\n  constructor() {\n    let constructs = window['constructs']('de');\n    \n    console.log('First name: '+constructs.name.getFirstName());\n  }\n}\n```\n\n### locales available\n- **af_ZA** _(South Africa)_\n- **ar** _(Argentina)_\n- **az** _(Azerbaijan)_\n- **cz** _(Czech Republic)_\n- **de** _(Germany - **Fallback locale**)_\n- **de_AT** _(Austria)_\n- **de_CH** _(Switzerland)_\n- **en** _(United States of America)_\n- **en_GB** _(United Kingdom)_\n- **es** _(Spain)_\n- **fr** _(France)_\n- **ge** _(Georgia)_\n- **gr** _(Greece)_\n- **hr** _(Croatia)_\n- **id** _(Indonesia)_\n- **il** _(Israel)_\n- **ir** _(Iran)_\n- **it** _(Italia)_\n- **jp** _(Japan)_\n- **lv** _(Latvia)_\n- **pl** _(Poland)_\n\n## Usage template\n\nconstructs.js can generate multiple random data at once based on object templates. These data packages can then be used e.g. for grids or displays.\n\n### Example\n```javascript\nlet template = {\n    name: \"Example template\",\n    structure: [\n        {\n            name: \"id\",\n            mask: \"[id]\"\n        },\n        {\n            name: \"first_name\",\n            mask: \"[name:getFirstName]\"\n        },\n        {\n            name: \"sur_name\",\n            mask: \"[name:getSurName]\"\n        },\n        {\n            name: \"name\",\n            mask: \"{first_name} {sur_name}\" // Merge field content from {\"name\": \"first_name\"} and {\"name\": \"sur_name\"}\n        },\n        {\n            name: \"birthday\",\n            mask: \"[date(1990-01-01, 1970-01-01)]\" // Generate date from 01.01.1970 and 01.01.1990\n        },\n        {\n            name: \"age\",\n            mask: \"[diffYearNow({birthday})]\" // Returns the difference in years from the field content {\"name\": \"birthday\"} returns\n        },\n        {\n            name: \"created_date\",\n            mask: \"[datetime]\"\n        }\n    ],\n    output: {\n        result: \"output\", // Use for API (Allowed: output, insert)\n        type: \"json\", // Result json object (Allowed: json, xml)\n        limit: 5 // Generate 5 items\n    }\n};\n\nlet generatedData = constructs.generateUniqData(template);\n\nconsole.log(generatedData);\n```\n\n### Output\n\n```json\n[\n  {\n    \"id\": 99848,\n    \"first_name\": \"Henrik\",\n    \"sur_name\": \"Ranz\",\n    \"name\": \"Henrik Ranz\",\n    \"birthday\": \"1979-03-08\",\n    \"age\": 42,\n    \"created_date\": \"2014-10-28 19:19:09\"\n  },\n  {\n    \"id\": 52560,\n    \"first_name\": \"Timothy\",\n    \"sur_name\": \"Frantz\",\n    \"name\": \"Timothy Frantz\",\n    \"birthday\": \"1981-03-14\",\n    \"age\": 40,\n    \"created_date\": \"2007-07-25 16:11:18\"\n  },\n  {\n    \"id\": 232936,\n    \"first_name\": \"Elli\",\n    \"sur_name\": \"Behrenbruch\",\n    \"name\": \"Elli Behrenbruch\",\n    \"birthday\": \"1971-09-06\",\n    \"age\": 50,\n    \"created_date\": \"2012-04-30 11:14:32\"\n  },\n  {\n    \"id\": 500971,\n    \"first_name\": \"Lennart\",\n    \"sur_name\": \"Fink\",\n    \"name\": \"Lennart Fink\",\n    \"birthday\": \"1983-04-06\",\n    \"age\": 38,\n    \"created_date\": \"2010-03-30 15:40:03\"\n  },\n  {\n    \"id\": 34174,\n    \"first_name\": \"Darleen\",\n    \"sur_name\": \"Töpfer\",\n    \"name\": \"Darleen Töpfer\",\n    \"birthday\": \"1973-06-28\",\n    \"age\": 48,\n    \"created_date\": \"2017-01-18 04:24:38\"\n  }\n]\n```\n\n## API\n\n### Standalone\n\n#### address\n\n##### getAddress\nGenerate random address. The structure of the address depends on the respective locale.\n```javascript\nlet address = constructs.address.getAddress();\n```\n```\nAm Neuenhof 53a, Baryllastadt 82559 Deutschland\nAm Nonnenbruch 716, Nord Tillmannscheid 97817 Deutschland\nKarlstr. 42b, Süd Emrescheid 07554 Deutschland\n```\n\n##### getStreet\nReturns a random street based on the locale.\n```javascript\nlet street      = constructs.address.getStreet();\n```\n```\nFriedrich-List-Str.\nAm Knechtsgraben\nMontanusstr.\n```\n\n##### getBuildingNumber\nGenerates a building number based on the defined scheme in locale.\n```javascript\nlet building_number = constructs.address.getBuildingNumber();\n```\n```\n244\n997b\n520a\n```\n\n##### getPostcode\nReturns a random zip code based on the locale.\n```javascript\nlet postcode      = constructs.address.getPostcode();\n```\n```\n03884\n57392\n82411\n```\n\n##### getState\nReturns a random state based on the locale.\n```javascript\nlet state      = constructs.address.getState();\n```\n```\nThüringen\nBremen\nNiedersachsen\n```\n\n#### city\n\n##### getCity\nGenerates a fictitious city name based on the first name and last name list from the locales.\n```javascript\nlet city = constructs.city.getCity();\n```\n```\nJankescheid\nDavinburg\nGregerdorf\n```\n\n##### getPrefix\nReturns a random prefix from the locale.\n```javascript\nlet city_prefix = constructs.city.getPrefix();\n```\n```\nNord\nOst\nWest\n```\n\n##### getSuffix\nReturns a random suffix from the locale.\n```javascript\nlet city_suffix = constructs.city.getSuffix();\n```\n```\nstadt\ndorf\nland\n```\n\n#### company\n\n##### getCompany\nGenerates a fictitious company name based on the first name and last name list from locales.\n```javascript\nlet company = constructs.company.getCompany();\n```\n```\nLoogen GmbH\nWartenberg, Helm und Többen\nNoack GmbH \u0026 Co KG\n```\n\n##### getSuffix\nReturns a random prefix from the locale.\n```javascript\nlet company_suffix = constructs.company.getSuffix();\n```\n```\nGmbH\nGbR\nAG\n```\n\n#### country\n\n##### getCountry\nReturns a random country which is stored in locale\n```javascript\nlet country = constructs.country.getCountry();\n```\n```\nItalien\n```\n\n##### getDefaultCountry\nReturns the default country\n```javascript\nlet country_default = constructs.country.getDefaultCountry();\n```\n```\nDeutschland\n```\n\n#### credit_card\n\n##### getNumber\nReturns a randomly generated credit card number based on the locales.The provider can be controlled via the \"types\" parameter.\n```javascript\nlet credit_card = constructs.credit_card.getNumber({type: 'amex'});\n```\n```\n5561-9631-7062-589\n```\n\n##### getMaestro\nReturns a randomly generated credit card number based on the locales.\n```javascript\nlet maestro = constructs.credit_card.getMaestro();\n```\n```\n5561-9631-7062-589\n```\n\n##### getMastercard\nReturns a randomly generated credit card number based on the locales.\n```javascript\nlet mastercard = constructs.credit_card.getMastercard();\n```\n```\n5561-9631-7062-589\n```\n\n##### getAmex\nReturns a randomly generated credit card number based on the locales.\n```javascript\nlet amex = constructs.credit_card.getAmex();\n```\n```\n5561-9631-7062-589\n```\n\n##### getVisa\nReturns a randomly generated credit card number based on the locales.\n```javascript\nlet visa = constructs.credit_card.getVisa();\n```\n```\n5561-9631-7062-589\n```\n\n#### email\n\n##### getEmail\nReturns a random email address based on a random last name from the locale and a random defined domain.\n```javascript\nlet email = constructs.email.getEmail();\n```\n```\nmicha@gmail.com\nfrenke@yahoo.com\n```\n\n##### getSuffix\nReturns a random suffix from the locale.\n```javascript\nlet email_suffix = constructs.email.getSuffix();\n```\n```\n@gmail.com\n@yahoo.com\n```\n#### image\n\n##### getImage\nReturns a random image based on the type in the local. By default the type \"avatar\" is set.  The images have a maximum size of 500x500 pixels.\n```javascript\nlet animal  = constructs.image.getAnimalImage(); // or .image.getImage({type: 'animal'})\nlet avatar  = constructs.image.getAvatarImage(); // or .image.getImage({type: 'avatar'})\nlet city    = constructs.image.getCityImage(); // or .image.getImage({type: 'city'})\nlet human   = constructs.image.getHumanImage(); // or .image.getImage({type: 'human'})\nlet nature  = constructs.image.getNatureImage(); // or .image.getImage({type: 'nature'})\nlet technic = constructs.image.getTechnicImage(); // or .image.getImage({type: 'technic'})\n```\n\n###### Animal\n\u003cimg width=\"200\" src=\"https://d22kzm8dnmp26q.cloudfront.net/animal/15.jpg\"\u003e\n\n###### Avatar\n\u003cimg width=\"200\" src=\"https://d22kzm8dnmp26q.cloudfront.net/avatar/33.jpg\"\u003e\n\n###### City\n\u003cimg width=\"200\" src=\"https://d22kzm8dnmp26q.cloudfront.net/city/17.jpg\"\u003e\n\n###### Human\n\u003cimg width=\"200\" src=\"https://d22kzm8dnmp26q.cloudfront.net/human/5.jpg\"\u003e\n\n###### Nature\n\u003cimg width=\"200\" src=\"https://d22kzm8dnmp26q.cloudfront.net/nature/32.jpg\"\u003e\n\n###### Technic\n\u003cimg width=\"200\" src=\"https://d22kzm8dnmp26q.cloudfront.net/technic/1.jpg\"\u003e\n\n#### loremIpsum\n\n##### getWords\nReturns a random sentence based on the words from the \"Lorem ipsum\" text. The number of words can be limited/extended by the \"words\" parameter.\n```javascript\nlet loremIpsum      = constructs.loremIpsum.getWords(); // return default 60 words\nlet loremIpsum10    = constructs.loremIpsum.getWords({max: 10}); // return 10 words\n```\n```\n60 words:\nAmet vero ullamcorper sea lorem dolor clita voluptua accusam dolores justo labore facilisis clita At dolor takimata facilisis consetetur erat sadipscing nibh diam tincidunt autem justo invidunt dolores magna vulputate blandit lorem aliquip mazim no molestie ipsum exerci vel dolor consectetuer facilisis nonumy ut takimata dolore rebum nisl dolor vero illum consequat facilisi feugiat ad option amet amet stet diam.\n\n10 words:\nSadipscing elitr aliquam est et accusam sadipscing assum eum molestie.\n```\n#### name\n\n##### getName\nReturns a random name based on the first name and last name list of the locale. Titles (doctor or professor) can also precede the names. \n```javascript\nlet name      = constructs.name.getName();\n```\n```\nEnes Kette\nFrau Prof. Jolie Polifka\nDr. Vito Kempter\n```\n\n##### getFirstName\nReturns a random first name from the list of locales.\n```javascript\nlet first_name = constructs.name.getFirstName();\n```\n```\nMaxel\nFrank\nBen\n```\n\n##### getSurName\nReturns a random surname based on the locale.\n```javascript\nlet sur_name      = constructs.name.getSurName();\n```\n```\nBremser\nRitosek\nLott\n```\n\n##### getSalutation\nReturns a random salutation based on the locale. \n```javascript\nlet gender = constructs.name.getSalutation();\n```\n```\nHerr\nFrau\nDiverses\n```\n\n##### getTitle\nReturns a random title based on the locale.\n```javascript\nlet title      = constructs.name.getTitle();\n```\n```\nDr.\nProf.\n```\n#### phone\n\n##### getCellPhoneNumber\nCreates a random cell phone number based on the scheme in locale.\n```javascript\nlet cell_phone = constructs.phone.getCellPhoneNumber();\n```\n```\n+49-152-1664339\n+49-1739-9267441\n```\n\n##### getPhoneNumber\nReturns a randomly generated phone number based on the local scheme.\n```javascript\nlet phone      = constructs.phone.getPhoneNumber();\n```\n```\n(0183) 837993227\n(01294) 4479364\n+49-174-9347731\n+49-1834-99411402\n```\n\n### Template\n\nThe template scheme is structured as follows and must be maintained.\n\n```\n{\n    structure: [\n        {\n            name: \"id\", // Field name\n            mask: \"[id]\" // Mask\n        }\n    ],\n    output: {\n        result: \"output\", // Use for API (Allowed: output, insert)\n        type: \"json\", // Result json object (Allowed: json, xml)\n        limit: 5 // Generate 5 items\n    }\n}\n```\n\n### Template masks\n\nThe mask is always structured according to the scheme \n```\n[module:function]\n```\nmodule: Class module\nfunction: function call\n\nFunction calls can also include parameters that can be processed further.\n\nSeveral [module:function] can also be listed in the masks.\n```\nProf. Dr. [name:getFirstName] [name:getSurName]\n```\nSo different masks can be combined in the input mask and normal text can be used.\n\nOther field contents can also be accessed in the masks.\nFor example, one has built a structure that looks like this:\n```\n{\n    \"name\": \"birthday\",\n    \"mask\": \"[date]\"\n},\n{\n    \"name\": \"age\"\n    \"mask\": \"[diffYearNow({birthday})]\"\n}\n```\nThen you can see that in the mask at the field **age** the field content **{birthday}** is accessed. It doesn't matter where the field is defined in the structure.\n\n### Module functions\n\n#### Global modules\n\n##### [id]\nReturns a random generated number which can be further restricted with the parameters **min** and **max**. \n```\n[id(min = 1, max = 1000000)]\n```\n\n##### [date]\nReturns a random generated date which can be further restricted with the parameters **min** (schema: 1970-01-01) and **max** (schema: 1970-01-01). \n```\n[date(min = null, max = null)]\n```\n\n##### [datetime]\nReturns a random generated datetime which can be further restricted with the parameters **min** (schema: 1970-01-01) and **max** (schema: 1970-01-01). \n```\n[datetime(min = null, max = null)]\n```\n\n##### [diffYearNow]\nCalculates the year which lies between the passed date and today's date.\n(schema: 1970-01-01 or 1970-01-01 00:00:00)\n```\n[diffYearNow(date)]\n```\n\n#### address\n\n##### [address:getAddress]\nReturns an address based on the locale.\n```\n[address:getAddress]\n```\n\n##### [address:getStreet]\nReturns a street based on the locale.\n```\n[address:getStreet]\n```\n\n##### [address:getBuildingNumber]\nReturns a building number based on the locales\n```\n[address:getBuildingNumber]\n```\n\n##### [address:getPostcode]\nReturns a post code based on the locales\n```\n[address:getPostcode]\n```\n\n##### [address:getState]\nReturns a state based on the locales\n```\n[address:getState]\n```\n\n#### city\n\n##### [city:getCity]\nReturns a city based on the locales\n```\n[city:getCity]\n```\n\n##### [city:getPrefix]\nReturns a prefix based on the locales\n```\n[city:getPrefix]\n```\n\n##### [city:getSuffix]\nReturns a suffix based on the locales\n```\n[city:getSuffix]\n```\n\n#### company\n\n##### [company:getCompany]\nReturns a company based on the locales\n```\n[company:getCompany]\n```\n\n##### [company:getSuffix]\nReturns a suffix based on the locales\n```\n[company:getSuffix]\n```\n\n#### country\n\n##### [country:getCountry]\nReturns a country based on the locales\n```\n[country:getCountry]\n```\n\n##### [country:getDefaultCountry]\nReturns the default country of the locale\n```\n[country:getDefaultCountry]\n```\n\n#### credit_card\n\n##### [credit_card:getNumber]\nReturns a credit card number based on the locales\n```\n[credit_card:getNumber(type = amex)]\n```\n\n##### [credit_card:getMaestro]\nReturns a credit card number based on the locales\n```\n[credit_card:getMaestro]\n```\n\n##### [credit_card:getMastercard]\nReturns a credit card number based on the locales\n```\n[credit_card:getMastercard]\n```\n\n##### [credit_card:getAmex]\nReturns a credit card number based on the locales\n```\n[credit_card:getAmex]\n```\n\n##### [credit_card:getVisa]\nReturns a credit card number based on the locales\n```\n[credit_card:getVisa]\n```\n\n\n#### email\n\n##### [email:getEmail]\nReturns a email based on the locales\n```\n[email:getEmail]\n```\n\n##### [email:getSuffix]\nReturns a suffix based on the locales\n```\n[email:getSuffix]\n```\n\n#### image\n\n##### [image:getImage]\nReturns a image based on the locale. The type parameter defines from which image pool a random image should come back. Existing image pools: animal, avatar(default), city, human, nature and technic\n```\n[image:getImage(type: null)]\n```\n\n##### [image:getAvatarImage]\nReturns a avatar image based on the locales\n```\n[image:getAvatarImage]\n```\n\n##### [image:getAnimalImage]\nReturns a animal image based on the locales\n```\n[image:getAnimalImage]\n```\n\n##### [image:getCityImage]\nReturns a city image based on the locales\n```\n[image:getCityImage]\n```\n\n##### [image:getHumanImage]\nReturns a human image based on the locales\n```\n[image:getHumanImage]\n```\n\n##### [image:getNatureImage]\nReturns a nature image based on the locales\n```\n[image:getNatureImage]\n```\n\n##### [image:getTechnicImage]\nReturns a technic image based on the locales\n```\n[image:getTechnicImage]\n```\n\n#### loremIpsum\n\n##### [loremIpsum:getWords]\nReturns a random Lorem ipsum text based on the locale. The parameter \"max\" can be used to specify the length of the returned sentence. By default the length is 60 words.\n```\n[loremIpsum:getWords(max: null)]\n```\n\n#### name\n\n##### [name:getName]\nReturns a name based on the locales\n```\n[name:getName]\n```\n\n##### [name:getFirstName]\nReturns a first name based on the locales\n```\n[name:getFirstName]\n```\n\n##### [name:getSurName]\nReturns a sur name based on the locales\n```\n[name:getSurName]\n```\n\n##### [name:getSalutation]\nReturns a salutation based on the locales\n```\n[name:getSalutation]\n```\n\n##### [name:getTitle]\nReturns a title based on the locales\n```\n[name:getTitle]\n```\n\n#### phone\n\n##### [phone:getPhoneNumber]\nReturns a phone number based on the locales\n```\n[name:getPhoneNumber]\n```\n\n##### [phone:getCellPhoneNumber]\nReturns a cell phone number based on the locales\n```\n[name:getCellPhoneNumber]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgerhardt-pressmind%2Fconstructs-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frgerhardt-pressmind%2Fconstructs-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgerhardt-pressmind%2Fconstructs-js/lists"}