Faker: Generate Massive Amounts of Fake Data in the Browser & Node.js


Generate massive amounts of fake (but realistic) data for testing and development.

πŸš€ Features

  • πŸ’Œ Locations - Generate valid looking Addresses, Zip Codes, Street Names, States, and Countries!
  • ⏰ Time-based Data - Past, present, future, recent, soon... whenever!
  • 🌏 Localization - Set a locale to generate realistic looking Names, Addresses, and Phone Numbers.
  • πŸ’Έ Finance - Create stubbed out Account Details, Transactions, and Crypto Addresses.
  • πŸ‘  Products - Generate Prices, Product Names, Adjectives, and Descriptions.
  • πŸ‘Ύ Hacker Jargon - β€œTry to reboot the SQL bus, maybe it will bypass the virtual application!”
  • 🧍 Names - Generate virtual humans with a complete online and offline identity.
  • πŸ”’ Numbers - Of course, we can also generate random numbers and strings.

Note: Faker tries to generate realistic data and not obvious fake data. The generated names, addresses, emails, phone numbers, and/or other data might be coincidentally valid information. Please do not send any of your messages/calls to them from your test setup.

πŸ“¦ Install

npm install --save-dev @faker-js/faker

πŸͺ„ Usage

// ESM
import { faker } from '@faker-js/faker';

// CJS
const { faker } = require('@faker-js/faker');

export function createRandomUser(): User {
  return {
    userId: faker.string.uuid(),
    username: faker.internet.userName(),
    email: faker.internet.email(),
    avatar: faker.image.avatar(),
    password: faker.internet.password(),
    birthdate: faker.date.birthdate(),
    registeredAt: faker.date.past(),

export const USERS: User[] = faker.helpers.multiple(createRandomUser, {
  count: 5,

The above code indicates a basic usage of Faker. The point of interest is the import statements at the top. The first import indicates how one can import the entirety of Faker, which includes every locale, while the commented-out import showcases how to import only a single locale. In most situations, importing a single locale is preferable for performance because some testing frameworks reload imports for every test file, which causes startup latencies to add up quickly. Thus, limiting the import to a single locale can speed up startup times.

πŸ’Ž Modules

An in-depth overview of the API methods is available in the documentation for v8 (stable) and v8.* (next).


Faker contains a generator method faker.helpers.fake for combining faker API methods using a mustache string format.

    'Hello {{person.prefix}} {{person.lastName}}, how are you today?'

🌏 Localization

Faker has support for multiple locales.

The main faker instance uses the English locale. But you can also import instances using other locales.

// ESM
import { fakerDE as faker } from '@faker-js/faker';

// CJS
const { fakerDE: faker } = require('@faker-js/faker');

See our documentation for a list of provided languages.

Please note: Not every locale provides data for every module. In our pre-made faker instances, we fall back to English in such a case as this is the most complete and most commonly used language. If you don't want that or prefer a different fallback, you can also build your own instances.

import { Faker, de, de_CH } from '@faker-js/faker';

export const faker = new Faker({
  locale: [de_CH, de],

βš™οΈ Setting a randomness seed

If you want consistent results, you can set your own seed:


const firstRandom = faker.number.int();

// Setting the seed again resets the sequence.

const secondRandom = faker.number.int();

console.log(firstRandom === secondRandom);

⚑️ Try it Online

Open in StackBlitz

πŸ“™ API Documentation

⚠️ You are reading the docs for the next branch ⚠️

Please proceed to the Getting Started Guide for the stable release of Faker.

For detailed API documentation, please select the version of the documentation you are looking for.

v8.* (next)https://next.fakerjs.dev/
v8 (stable)https://fakerjs.dev/
v7 (old)https://v7.fakerjs.dev/

✨ Contributing

Please make sure to read the Contributing Guide before making a pull request.

πŸ“ Changelog

Detailed changes for each release are documented in the release notes.

πŸ“œ What happened to the original faker.js?

Read the team update (January 14th, 2022).

Download Details:

Author: faker-js
Source Code: https://github.com/faker-js/faker 
License: View license

#javascript #nodejs #data #browser #fake 

Faker: Generate Massive Amounts of Fake Data in the Browser & Node.js
1.65 GEEK