1.0.1 • Published yesterday

mockdrop

Licence

MIT

Version

1.0.1

Deps

Size

327 kB

Vulns

Weekly

Summary Dependency Versions

Mockdrop

Generate high-quality dummy data instantly. Zero dependencies. Works everywhere.

A zero-dependency, isomorphic dummy data generator with a schema-based API, deep customization, and a pluggable architecture built for scale.

Installation

npm install mockdrop

yarn add mockdrop

pnpm add mockdrop

Quick Start

import mockdrop from "mockdrop";

// Generate an array of 20 lead objects
const leads = mockdrop.create({
  leadName: () => mockdrop.projectName(),
  leadDescription: () => mockdrop.projectDescription(),
  leadAmount: () => mockdrop.amount(1000, 50000),
  leadCreatedAt: () => mockdrop.past(),
  leadCreatedBy: () => mockdrop.fullName(),
  leadSource: () => mockdrop.platformName(),
  leadEmail: () => mockdrop.email({ domain: 'mailinator.com' })
}, 20);

console.log(leads);

Schema value rules

Each value in a create() schema can be:

Value	Behavior
A generator reference — `mockdrop.projectName` (no parentheses)	Called once per item, so every row gets a fresh value
An arrow function — `() => mockdrop.email({ domain: 'mailinator.com' })`	Same, but lets you pass options
A function using the index — `(i) => i + 1`	Receives the item index (auto-increment ids)
A nested object	Resolved recursively as a sub-schema
Anything else — `'admin'`, `42`, `true`	Copied as-is into every item

Don't call the generator inside the schema (leadName: mockdrop.projectName()) — that runs once and repeats the same value in all rows. Pass the reference or wrap it in an arrow function.

Customizing Email Domains

Want all emails to come from a specific domain for testing?

const user = mockdrop.create({
  name: () => mockdrop.fullName(),
  email: () => mockdrop.email({ domain: 'mailinator.com' })
});

console.log(user[0].email); // e.g. "jayesh.goswami@mailinator.com"

Reproducible Data (Seeding)

Mockdrop uses a seedable PRNG so you can generate the exact same data every time, useful for snapshot testing:

mockdrop.setSeed(42);
console.log(mockdrop.fullName()); // Always returns the same name for seed 42

API Reference

Mockdrop provides an extensive set of generators organized by namespace. You can access them via their namespace (mockdrop.person.fullName()) or via top-level aliases (mockdrop.fullName()).

Person (`mockdrop.person`)

firstName()
lastName()
fullName()
age(min, max)
gender()
avatar()
bio()
phone(format)
jobTitle()
prefix()

mockdrop.user is an alias for mockdrop.person, with user.name() mapping to fullName() — so schemas can read naturally: createdBy: mockdrop.user.name.