JSON モックデータ生成

JSON Schema 入力

1

生成されたモックデータ 出力

設定
配列数3

配列フィールド内で Faker が生成するオブジェクト数を制御します。

任意プロパティ80%

required ではないプロパティを含める確率です。

Seed

固定すると Faker 出力の再現性を保てます。

ロケール

氏名、住所、電話番号などにロケールパックを使います。

バッチサイズ

トップレベルのレコードをまとめて生成します。大きいほど時間がかかる場合があります。

数値分布

最小~最大制約の範囲に均等に分布します。

欠損値確率0%

null やプロパティ欠落を混ぜて、欠損データを模倣します。

汚れ値確率0%

プリミティブの一部を "N/A" のような文字列に置換して検証をストレステストします。

モックデータを生成

JSON Schema を入力して、テスト/開発向けの現実的なモックデータを生成します

一般的な JSON Schema 型に対応

現実的なダミーデータを生成

データ数とロケールをカスタマイズ

バッチモード&不完全データのシミュレーション

JSON Schema からモック JSON を生成する方法 – ステップガイド

API テスト、UI プロトタイピング、負荷テスト、コントラクト駆動開発のために、JSON Schema から現実的なダミー JSON を生成します。

  1. ステップ 1 – JSON Schema を用意する

    • 左側のエディターにスキーマを貼り付けるか、ファイル/URL/サンプルからインポートします。
    • 可能であれば実際の API スキーマから始めると、本番に近いモックデータになります。
  2. ステップ 2 – スキーマをモック生成向けに整える

    • 未対応の keyword( $ref, dependencies, 条件スキーマ (if/then/else).
    • スキーマが $ref, を使っている場合は、スキーマを事前読み込みして dereference するツール(例:コード→スキーマ変換ページの「モックデータ生成」)から Mock Generator を開くことを検討してください。
    • types/properties/required/items/formats/constraints に焦点を当てたスキーマに保つと安定します。
  3. ステップ 3 – 生成設定を調整する

    • 氏名、住所、電話番号などが自然になるようにロケールを選びます。
    • seed を設定すると再現性のあるモックデータを生成できます(テストやスナップショットに便利)。
    • バッチサイズ、配列数、数値分布、任意フィールド確率を調整します。
    • 欠損/汚れデータのシミュレーションで、検証と UI のエラーハンドリングをテストします。
  4. ステップ 4 – 生成して出力を確認する

    • 「モックデータ生成」をクリックして、スキーマ制約に従う出力を生成します。
    • 値が期待と違う場合は、スキーマ(format、enum、min/max など)を引き締めて再生成します。
  5. ステップ 5 – テストやジェネレーターで使う

    • JSON をコピー/ダウンロードし、単体/統合テストの fixture として利用します。
    • 生成された JSON をコードジェネレーター(TypeScript/Java など)に渡して、一致する DTO を作成します。

JSON Schema 機能に関する重要な注意

  • $ref, dependencies, if/then/else に依存するスキーマは、モック生成前に簡略化または dereference が必要です。
  • スキーマバリデータは draft や keyword の解釈が異なる場合があります。厳密なコントラクト検証は CI でフルバリデータを使ってください。
例:JSON Schema → モック JSON
// JSON Schema (input)
{
  "type": "object",
  "properties": {
    "id": { "type": "string", "format": "uuid" },
    "email": { "type": "string", "format": "email" },
    "active": { "type": "boolean" },
    "createdAt": { "type": "string", "format": "date-time" }
  },
  "required": ["id", "email", "active", "createdAt"]
}

// Mock JSON (output example)
{
  "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "email": "[email protected]",
  "active": true,
  "createdAt": "2024-03-01T10:15:00.000Z"
}

関連するスキーマ/コード生成ツール

スキーマ生成、コントラクト検証、安定した JSON 例からの型付きコード生成に役立ちます。

よくある質問

モックデータ生成とは?

モックデータ生成は、JSON Schema 定義に基づいて現実的なダミーデータを作ることです。データ構造に合うサンプルが必要なテスト、開発、プロトタイピングで役立ちます。

ジェネレーターはどのように動作しますか?

JSON Schema を解析し、定義された型、制約、format に従うデータを生成します。文字列、数値、boolean、配列、オブジェクトに加え、email、date、UUID などの一般的な文字列 format に対応します。

どんな生成オプションがありますか?

設定パネルで出力を細かく調整できます。配列サイズ、バッチサイズ、ロケール、乱数 seed の固定、数値分布の選択、任意プロパティの確率、欠損/汚れデータのシミュレーションなどに対応します。

対応しているスキーマ機能は?

基本型、object の properties、配列、文字列 format、enum、const、min/max 制約、anyOf/oneOf/allOf などの一般的な合成 keyword に対応します。$ref、dependencies、if/then/else 条件などを使うスキーマは、モック生成前に簡略化または dereference が必要な場合があります。

生成結果の再現性を保つには?

設定パネルの seed を使うと、毎回同じデータを生成できます。安定したテストシナリオや、特定データセットの再現に便利です。

データ量は制御できますか?

はい。配列数(フィールドごとのコレクションサイズ)とバッチサイズ(トップレベル件数)で制御できます。任意プロパティ確率、欠損値、汚れ値のスライダーで、疎なデータや汚いデータも模倣できます。

JSON モックデータ生成 | JSONSwiss