{"id":13457700,"url":"https://github.com/faker-js/faker","last_synced_at":"2026-04-02T11:20:30.369Z","repository":{"id":37003225,"uuid":"445599288","full_name":"faker-js/faker","owner":"faker-js","description":"Generate massive amounts of fake data in the browser and node.js","archived":false,"fork":false,"pushed_at":"2025-05-04T12:16:19.000Z","size":30940,"stargazers_count":13786,"open_issues_count":126,"forks_count":972,"subscribers_count":34,"default_branch":"next","last_synced_at":"2025-05-05T14:09:48.962Z","etag":null,"topics":["browser","data","fake","faker","javascript","nodejs","typescript"],"latest_commit_sha":null,"homepage":"https://fakerjs.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/faker-js.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":null,"patreon":null,"open_collective":"fakerjs","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2022-01-07T17:22:27.000Z","updated_at":"2025-05-05T14:01:31.000Z","dependencies_parsed_at":"2024-03-16T16:28:27.541Z","dependency_job_id":"7040e2b5-afcc-4809-939b-98b039f1737e","html_url":"https://github.com/faker-js/faker","commit_stats":{"total_commits":3312,"total_committers":497,"mean_commits":6.663983903420523,"dds":0.7865338164251208,"last_synced_commit":"d5163924ea457616cb7779e511f166386c182fdb"},"previous_names":[],"tags_count":92,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faker-js%2Ffaker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faker-js%2Ffaker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faker-js%2Ffaker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faker-js%2Ffaker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faker-js","download_url":"https://codeload.github.com/faker-js/faker/tar.gz/refs/heads/next","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252551644,"owners_count":21766581,"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":["browser","data","fake","faker","javascript","nodejs","typescript"],"created_at":"2024-07-31T09:00:33.887Z","updated_at":"2026-04-02T11:20:30.364Z","avatar_url":"https://github.com/faker-js.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./docs/public/logo.svg\" width=\"200\"/\u003e\n  \u003ch1\u003eFaker\u003c/h1\u003e\n  \u003cp\u003eGenerate massive amounts of fake (but realistic) data for testing and development.\u003c/p\u003e\n  \n  [![npm version](https://badgen.net/npm/v/@faker-js/faker)](https://www.npmjs.com/package/@faker-js/faker)\n  [![npm downloads](https://badgen.net/npm/dm/@faker-js/faker)](https://www.npmjs.com/package/@faker-js/faker)\n  [![Continuous Integration](https://github.com/faker-js/faker/actions/workflows/ci.yml/badge.svg)](https://github.com/faker-js/faker/actions/workflows/ci.yml)\n  [![codecov](https://codecov.io/gh/faker-js/faker/branch/next/graph/badge.svg?token=N61U168G08)](https://codecov.io/gh/faker-js/faker)\n  [![Chat on Discord](https://img.shields.io/badge/chat-discord-blue?style=flat\u0026logo=discord)](https://chat.fakerjs.dev)\n  [![Open Collective](https://img.shields.io/opencollective/backers/fakerjs)](https://opencollective.com/fakerjs#section-contributors)\n  [![sponsor](https://img.shields.io/opencollective/all/fakerjs?label=sponsors)](https://opencollective.com/fakerjs)\n\u003c/div\u003e\n\n## ⚡️ Try it Online\n\n[Open in StackBlitz](https://fakerjs.dev/new)\n\n## 📙 API Documentation\n\n\u003ch1\u003e⚠️ You are reading the docs for the \u003ca href=\"https://github.com/faker-js/faker/tree/next\"\u003enext\u003c/a\u003e branch ⚠️\u003c/h1\u003e\n\nPlease proceed to the [Getting Started Guide](https://fakerjs.dev/guide/) for the **stable** release of Faker.\n\nFor detailed API documentation, please select the version of the documentation you are looking for.\n\n|   Version    | Website                   |\n| :----------: | :------------------------ |\n|  v10 (next)  | https://next.fakerjs.dev/ |\n| v10 (stable) | https://fakerjs.dev/      |\n|   v9 (old)   | https://v9.fakerjs.dev/   |\n\n---\n\n## 🚀 Features\n\n- 🧍 Person - Generate Names, Genders, Bios, Job titles, and more.\n- 📍 Location - Generate Addresses, Zip Codes, Street Names, States, and Countries!\n- ⏰ Date - Past, present, future, recent, soon... whenever!\n- 💸 Finance - Create stubbed out Account Details, Transactions, and Crypto Addresses.\n- 👠 Commerce - Generate Prices, Product Names, Adjectives, and Descriptions.\n- 👾 Hacker - “Try to reboot the SQL bus, maybe it will bypass the virtual application!”\n- 🔢 Number and String - Of course, we can also generate random numbers and strings.\n- 🌏 Localization - Pick from over 70 locales to generate realistic looking Names, Addresses, and Phone Numbers.\n\n\u003e **Note**: Faker tries to generate realistic data and not obvious fake data.\n\u003e The generated names, addresses, emails, phone numbers, and/or other data might be coincidentally valid information.\n\u003e Please do not send any of your messages/calls to them from your test setup.\n\n## 📦 Install\n\n```bash\nnpm install --save-dev @faker-js/faker\n```\n\n## 🪄 Usage\n\n```ts\n// ESM\nimport { faker } from '@faker-js/faker';\n\n// CJS\nconst { faker } = require('@faker-js/faker');\n\nexport function createRandomUser() {\n  return {\n    userId: faker.string.uuid(),\n    username: faker.internet.username(),\n    email: faker.internet.email(),\n    avatar: faker.image.avatar(),\n    password: faker.internet.password(),\n    birthdate: faker.date.birthdate(),\n    registeredAt: faker.date.past(),\n  };\n}\n\nexport const users = faker.helpers.multiple(createRandomUser, {\n  count: 5,\n});\n```\n\n## 💎 Modules\n\nAn in-depth overview of the API methods is available in the documentation for [v10 (stable)](https://fakerjs.dev/api/) and [v10.\\* (next)](https://next.fakerjs.dev/api/).\n\n### Templates\n\nFaker contains a generator method `faker.helpers.fake` for combining faker API methods using a mustache string format.\n\n```ts\nconsole.log(\n  faker.helpers.fake(\n    'Hello {{person.prefix}} {{person.lastName}}, how are you today?'\n  )\n);\n```\n\n## 🌏 Localization\n\nFaker has support for multiple locales.\n\nThe main `faker` instance uses the English locale.\nBut you can also import instances using other locales.\n\n```ts\n// ESM\nimport { fakerDE as faker } from '@faker-js/faker';\n\n// CJS\nconst { fakerDE: faker } = require('@faker-js/faker');\n```\n\nSee our documentation for a list of [provided languages](https://fakerjs.dev/guide/localization.html#available-locales).\n\nPlease note: Not every locale provides data for every module. In our pre-made faker instances,\nwe fall back to English in such a case as this is the most complete and most commonly used language.\nIf you don't want that or prefer a different fallback, you can also build your own instances.\n\n```ts\nimport { de, de_CH, Faker } from '@faker-js/faker';\n\nexport const faker = new Faker({\n  locale: [de_CH, de],\n});\n```\n\n## ⚙️ Setting a randomness seed\n\nIf you want consistent results, you can set your own seed. If you are using `faker.date` methods, there are additional considerations. See [Reproducible Results](https://fakerjs.dev/guide/usage.html#reproducible-results).\n\n```ts\nfaker.seed(123);\n\nconst firstRandom = faker.number.int();\n\n// Setting the seed again resets the sequence.\nfaker.seed(123);\n\nconst secondRandom = faker.number.int();\n\nconsole.log(firstRandom === secondRandom);\n```\n\n## 🤝 Sponsors\n\nFaker is an MIT-licensed open source project with its ongoing development made possible entirely by the support of these awesome backers\n\n### Sponsors\n\n![](https://opencollective.com/fakerjs/organizations.svg)\n\n### Backers\n\n![](https://opencollective.com/fakerjs/individuals.svg)\n\n## ✨ Contributing\n\nPlease make sure to read the [Contributing Guide](https://github.com/faker-js/faker/blob/next/CONTRIBUTING.md) before making a pull request.\n\n## 📘 Credits\n\nThanks to all the people who already contributed to Faker!\n\n\u003ca href=\"https://github.com/faker-js/faker/graphs/contributors\"\u003e\u003cimg src=\"https://opencollective.com/fakerjs/contributors.svg?width=800\" /\u003e\u003c/a\u003e\n\nThe [fakerjs.dev](https://fakerjs.dev) website is generously hosted by [Netlify](https://www.netlify.com/), with search functionality powered by [Algolia](https://www.algolia.com/).\n\n## 📝 Changelog\n\nDetailed changes for each release are documented in the [release notes](https://github.com/faker-js/faker/blob/next/CHANGELOG.md).\n\n## 📜 What happened to the original faker.js?\n\nRead the [team update](https://fakerjs.dev/update.html) (January 14th, 2022).\n\n## 🔑 License\n\n[MIT](https://github.com/faker-js/faker/blob/next/LICENSE)\n","funding_links":["https://opencollective.com/fakerjs"],"categories":["TypeScript","Test Data \u0026 Mocking","Repository","Uncategorized","Networking","Utilities","browser","Languages",":books: Libraries","Data"],"sub_categories":[".NET","Testing","Uncategorized","Web","Test Data","Universal","Generation/Masking/Subsetting"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaker-js%2Ffaker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaker-js%2Ffaker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaker-js%2Ffaker/lists"}