Comparison · target: json-schema-faker vs faker-js

json-schema-faker vs @faker-js/faker for Customer directory fixture

User must pick between a schema-driven faker and a data-library faker.

Direct answer

For the Customer directory fixture, json-schema-faker and @faker-js/faker are built for generating values for one document, not for 9 constraints that decide whether the output loads.

The comparison holds for a schema of this size — 1 tables — and does not claim anything about runtime, community size or pricing.

A compatibility table below scores json-schema-faker and @faker-js/faker against the same Customer directory fixture; the foreign key row is decisive, because a document carries a dangling reference without any tool objecting until load time.

Data as of 2026-11-18 · source: 1 Stack Overflow questions, @faker-js/faker at 95,721,308 monthly downloads · negative-case messages reproduced by executing the fixture against a local SQL engine (Node.js v24.22.0, engine 3.53.4) at 2026-11-18T11:53:54.233Z

The scorecard — Customer directory

The scorecard is scored against one shared fixture: Customer directory fixture, 1 tables and 7 columns. Each row states what a tool has to do for the output to load, and the note column says which property of the fixture decided the row. Rows are not weighted by preference; a row is decided by whether the output would load.

Where json-schema-faker wins

json-schema-faker is the better choice when the output is a single document: it reads the schema properties and generates a value for each one, which is what a unit test needs when the data carries no relationships. The Customer directory fixture is the shared reference for every row in the table above.

Where @faker-js/faker wins

@faker-js/faker is the better choice when the output is a single document: it reads the schema properties and generates a value for each one, which is what a unit test needs when the data carries no relationships. Neither of the two reads 9 constraints of this fixture as a database contract, which is the part a seed has to satisfy before a single row can be inserted.

How the rows were decided

Every row in the scorecard is decided by a property of the fixture, not by reading documentation. For Customer directory fixture, the deciding fixture properties were the customers.country range declaration, the NOT NULL columns. A tool that misses any one of those produces output that a database will refuse.

A note on what this comparison does not cover

This comparison measures output correctness on one fixture. It does not measure runtime, community size, documentation quality or long-term maintenance, and it does not claim that either tool is wrong for your project. It also does not compare pricing, because every row is decided by the schema rather than by a price list: what a tool charges says nothing about whether its output loads.

What the Customer directory fixture requires: schema-to-SQL vs document generationEight criteria, each decided by a property of the fixture rather than by preference. The left column is what a schema-to-SQL generator does with it; the right column is what document generation leaves unresolved.
CriterionSchemaSeedDocument generationWhat decided it
Reads a multi-file OpenAPI documentyespartialboth resolve local $ref chains
Honours NOT NULLyespartialboth read the required array
Honours enum, range and length declarationsyespartialthe fixture declares customers.country with char_length("country") = 2; the declaration is read out of the schema, the DDL carries it as a CHECK constraint and the value that breaks it ships as a negative case
Honours enum membersyespartialthe enum array is copied verbatim
Produces SQL, not just JSONyesnooutput format is the difference
Resolves foreign keys across schemasyesnoa single-schema faker has no second schema to read
Emits deliberately invalid instancesyesnonegative cases are a separate output
Same seed produces the same bytesyesyesboth are seedable
The four checks that decide whether a schema tool is enough for Customer directoryApplied to Customer directory fixture.
CheckResult on this fixtureConsequence
More than one table references anothernoa per-schema faker is sufficient
Output has to be SQL, not JSONyes — the target is PostgreSQLa document generator produces the wrong artefact
Tests must assert the API rejects bad inputyes — a negative case for every declaration in the schemanegative instances have to be generated separately
Same seed must reproduce the same bytesyes — seed 42 is fixedfixtures can be committed and diffed
index.ts

npx --yes @wenlu8848/schemaseed generate --input ./cmp_customers.openapi.yaml --out ./seed --formats ts --count 10 --seed 42

Download cmp_customers.openapi.yaml

// Generated by schemaseed.

export * from './customers.js';

Frequently asked questions

Which one should I pick?
If the output has to load into a database and the schema has relationships, take the schema-to-SQL tool. On Customer directory fixture the deciding constraint was customers.country.
How many criteria were compared?
Eight, each decided by a property of the Customer directory fixture: 1 tables and 7 columns.
Was this a benchmark?
No. It is one 1-table fixture of 7 columns measured on whether the produced rows satisfy the schema, not on speed, memory or price.
Do both tools produce deterministic output?
Both are seedable, which is why the Customer directory fixture rows can be committed and diffed; on this fixture that is the one property the two share.

Run it against your own schema

SchemaSeed is MIT licensed and free: unlimited local generation, no account, no telemetry and no usage limit. It reads your schema file on your own machine, so nothing is uploaded anywhere. If it saves you time, you can support the project.

Get SchemaSeed — free Support the project

Questions: support@schemaseed.drz8848.win