# Faker.js — Generate Realistic Fake Data for Testing

> Faker.js generates realistic fake data (names, addresses, emails, products, and more) for testing, seeding databases, and building prototypes in JavaScript and TypeScript.

## Install

Save in your project root:

# Faker.js — Generate Realistic Fake Data for Testing

## Quick Use
```bash
npm install @faker-js/faker
```
```javascript
import { faker } from '@faker-js/faker';
const user = {
  name: faker.person.fullName(),
  email: faker.internet.email(),
  avatar: faker.image.avatar(),
  address: faker.location.streetAddress()
};
console.log(user);
```

## Introduction
Faker.js is a community-maintained library that produces realistic fake data across dozens of categories. It is widely used for seeding test databases, generating sample UIs, populating prototypes, and writing automated tests that need varied, human-looking input.

## What Faker.js Does
- Generates fake names, emails, phone numbers, addresses, and company data
- Produces random dates, UUIDs, colors, images, lorem ipsum, and file paths
- Supports locale-specific data for 60+ languages and regions
- Provides deterministic output via seed values for reproducible tests
- Offers a tree-shakeable API organized by domain modules

## Architecture Overview
Faker.js is structured into domain modules (person, internet, location, commerce, etc.), each containing generator functions. Generators compose smaller helpers (random selection from weighted datasets, format strings, checksums) to produce realistic output. A Mersenne Twister PRNG underpins all randomness, and setting a seed makes every call deterministic. Locale datasets are loaded lazily and can be mixed (e.g., base English with German names).

## Self-Hosting & Configuration
- Install from npm: `npm install @faker-js/faker`
- Import the default English locale: `import { faker } from '@faker-js/faker'`
- For other locales, import from `@faker-js/faker/locale/de` (German), etc.
- Set `faker.seed(42)` for deterministic, reproducible output in tests
- Use tree-shaking-friendly imports to reduce bundle size if used in browser tests

## Key Features
- 80+ data modules covering names, addresses, finance, commerce, science, and more
- Locale support for 60+ languages with culturally appropriate names and formats
- Seed-based deterministic generation for repeatable test fixtures
- Helper utilities for generating arrays, unique values, and weighted random picks
- Active community maintenance with regular releases and new data modules

## Comparison with Similar Tools
- **Chance.js** — general random data generator; Faker.js has more domain-specific modules and locale support
- **Falso** — tree-shakeable fake data library; Faker.js has a larger dataset and broader community
- **Factory.js / Fishery** — factory patterns for model instances; Faker.js generates the raw data to fill those factories
- **Mimesis (Python)** — Python fake data provider; Faker.js fills the same role for the JavaScript ecosystem
- **JSON Schema Faker** — generates data from JSON Schema definitions; Faker.js provides freeform data without a schema

## FAQ
**Q: Is this the same as the original faker.js that was deleted?**
A: No. `@faker-js/faker` is a community fork maintained by a team of contributors after the original package was removed from npm in 2022.

**Q: Can I use Faker.js in production code?**
A: It is designed for development, testing, and demos. Using it in production for user-facing data is not recommended.

**Q: How do I generate the same data every time for snapshot tests?**
A: Call `faker.seed(12345)` before generating data. The same seed produces identical output across runs.

**Q: Does Faker.js support custom data providers?**
A: You can extend Faker by writing custom modules or overriding locale datasets. The API is designed to be composable.

## Sources
- https://github.com/faker-js/faker
- https://fakerjs.dev/

---
Source: https://tokrepo.com/en/workflows/565112f4-40e4-11f1-9bc6-00163e2b0d79
Author: AI Open Source