モックJSONのダミーデータ生成とAPIテスト設計

公開ツールダミーデータ(モックJSON)ジェネレーター

目次
  1. 1. ダミーデータ生成の基本構造
  2. 2. 偽データ(Mock JSON)を使ったAPIテストのチェックポイント
  3. 3. 完全なAPI模擬のためのダミーデータの注意点
  4. まとめ
  5. よくある質問

Webサービス開発の初期段階で、バックエンドAPIサーバーのデータベースモデル設計やAPIコントローラーのエンドポイント実装がまだ完了していないと、フロントエンドの開発者は機能の検証やUIレイアウトのレンダリングに苦労することになります。

そんなとき必要になるのが、API仕様書に記載されたJSON構造と一致する精巧なダミーデータ(Mock Data)です。この記事では、ランダムなダミーJSONデータをコードで直接生成する方法と、その過程で見落としがちなAPIテストのチェックポイントをまとめます。


1. ダミーデータ生成の基本構造

定型化された偽のデータセット(Mock JSON)を自動生成するロジックは、ほとんどが次のような繰り返し構造に集約されます。

mockDataset = [ template(i) for i in 1..N ]

ここでNは生成したいレコード(Record)の総数、template(i)はインデックスiを受け取り、ランダムなデータフィールドを埋めたオブジェクトを1つ返す関数です。

データ項目ごとにランダム値を埋める方法

  • 一意の識別子(連番ID / UUID): 連番の整数値(i + 1)、または標準RFC4122規格に準拠する36桁のUUID文字列(ブラウザのcrypto.randomUUID())を割り当てます。
  • ランダムな名前の選択: あらかじめ用意した名前の配列からインデックスをランダムに取り出して1つ選びます。
    const selectedName = list[Math.floor(Math.random() * list.length)];
  • 日付範囲へのランダムな割り当て: 開始時刻と終了時刻の間のミリ秒区間からランダムな地点を選び、日付文字列に変換します。
    const randomDate = start + Math.random() * (end - start);

この3つのパターンさえ押さえれば、連番ID・UUID・名前・日付が混ざったダミーレコードを自分でコードで作れます。ただしフィールドが増えたり、スキーマを頻繁に変更したりする場合は、毎回このロジックを手で書き直すよりも、フィールド名と型を指定するだけで結果をすぐに出力してくれるツールを使うほうが速く進みます。

私たちのツールで確認する。 フィールド名・データ型・行数を指定するだけで、上記のロジックをそのまま適用したJSON配列をすぐに生成します。

ダミーデータ(モックJSON)ジェネレーター

必要な件数と、オブジェクトのフィールド名・データ型(氏名、メール、乱数など)を指定すると、ダミーのJSON配列データをすぐに出力できます。


2. 偽データ(Mock JSON)を使ったAPIテストのチェックポイント

偽データをWeb UIに連携してテストするときは、実際のリモートサーバーとの通信環境に近いレイテンシ(Network Latency)もあわせて模擬するとよいでしょう。

  • ネットワーク遅延の模擬: ローカル開発環境ではデータの読み込みが0msに近く、ローディングスピナーなどのUIコンポーネントが実際に表示されるかどうかを確認するのが困難です。PromiseとsetTimeoutを組み合わせて、意図的に任意の遅延を入れてテストします。
    // 実際のAPI通信のように動作する、偽データ取得用のPromise
    function fetchMockUsers() {
      return new Promise((resolve) => {
        setTimeout(() => {
          resolve(mockUserDatabase);
        }, 800); // 0.8秒のネットワークレイテンシを人為的に付与
      });
    }

ダミーデータを作るたびにコード上へデータ生成用の関数を新しく書き足す代わりに、必要なデータ量とスキーマ構造を指定するだけで、Mock JSON配列をすぐに生成してコピーできます。


3. 完全なAPI模擬のためのダミーデータの注意点

項目確認するポイント
エッジケース極端に長い名前の値、値が空のnull、空の配列など、異常なレコードを一部混ぜておくと、レイアウトの崩れやCannot read property of undefinedのような参照エラーを事前に見つけられます
リレーションデータの整合性投稿と投稿者を一緒に生成する場合、投稿のauthorIdの値が投稿者リストのidのいずれかと一致していなければ、画面へのバインディングでエラーが起きます
データ型フロントエンドのコードが期待する型(文字列/数値/真偽値)と、実際に生成された値の型が一致しているかを確認します

まとめ

  • ダミーデータの生成は、結局のところインデックスを使った繰り返し処理の中で、フィールドごとにランダムな値を埋めていく構造です。
  • 連番ID・UUID・名前・日付は、それぞれ決まったルール(カウンター、crypto.randomUUID()、配列のインデックス参照、区間の乱数)で埋められます。
  • エッジケースと参照の整合性をあわせて確認することで、実際の画面で起きるエラーを事前に防げます。
ダミーデータ(モックJSON)ジェネレーター

必要な件数と、オブジェクトのフィールド名・データ型(氏名、メール、乱数など)を指定すると、ダミーのJSON配列データをすぐに出力できます。

よくある質問

対応しているデータ型にはどのようなものがありますか?

フィールドごとに、連番ID、UUID、名前、メールアドレス、乱数、日付、真偽値、そして単語リストを自分で指定するカスタムEnumまで、型を選べます。フィールド名と型、生成する行数(Row count)を決めるだけで、それに合ったJSON配列が作成されます。

カスタムEnumはどのように動作しますか?

カンマ(,)で区切った単語リスト(例: admin, user, guest)を書いておくと、各行のデータを生成するときに、その単語の中から1つをランダムに割り当てます。ステータス値やロール(Role)のように、決まった値のうち1つだけが入るべきフィールドに適しています。

できあがった結果はどのように使いますか?

「生成する」ボタンを押すと、結果のJSONデータを画面ですぐに確認でき、クリップボードへのコピーやファイルへの保存ができるので、そのままフロントエンドのモックアップコードやAPIテストに貼り付けて使えます。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. モールス信号 音の長さの公式とWeb Audio APIモールス信号の音の長さの公式(短点1・長点3)と、Web Audio APIのオシレーターでビープ音を合成する方法を解説します。周波数とWPMの考え方も整理します。
  2. モールス信号の変換方法とアルファベット対応表点(.)と線(-)の組み合わせで文字を表すモールス信号について、アルファベット・数字の対応表と、文字と単語を区切る変換ルールを解説します。
  3. 英語名のイニシャル変換|抽出ルールと大文字表記の基本姓と名の順序、大文字への統一、区切り記号の付け方など、英語のフルネームからイニシャルを作る手順と、航空券や署名まわりで迷いやすい点を整理して解説します。
  4. コンピュータの基数変換の公式と2進数・8進数・10進数・16進数の計算方法2進数・8進数・10進数・16進数が互いに変換される仕組みと、JavaScriptのtoString/parseIntの使い方、浮動小数点の誤差が生じる理由を解説します。
  5. OGPメタタグ設定法|SNS共有カードの表示を最適化カカオトークやX、Facebookでリンクを共有したとき、画像付きのプレビューカードを出すためのog:titleやog:imageなど必須メタタグと、1200×630pxの画像規格を解説します。
  6. NATOフォネティックコード一覧|A=Alphaから数字まで電話や無線で英字を伝えるときのNATO標準フォネティックコードをA~Zまで一覧で確認できます。数字の読み方や変換ツールの使い方もまとめました。

関連ツール