JSON → Zod スキーマ生成
JSON のサンプルから、Zod のスキーマを作ります。「import { z } from 'zod'」、「z.object({...})」 のスキーマ、「z.infer」 で型を取り出す1行が出力されるので、そのまま貼って 「schema.parse(data)」 で API レスポンスなどを検証できます。配列の要素の形が違うときは1つにまとめ、一部の要素にしかないキーは 「.optional()」、「文字列か null」のような値は 「.nullable()」 になります。空の配列は 「z.array(z.unknown())」 です。数値は整数も小数も 「z.number()」、日時の文字列も 「z.string()」 なので、「.int()」・「.datetime()」 や、文字数・範囲の制約は手で足してください。サンプル1つからの推論です。処理はすべてブラウザの中で行われ、JSON は送信されません。
他のバリデータ: Valibot・JSON Schema
同じ JSON から、Valibot のスキーマか JSON Schema(draft 2020-12)を作ります。配列の要素は 1 つにまとめられ、一部のオブジェクトにしか無いキーは省略可能になります。上の「文字列の形式を使う」とルート名の指定も反映されます。
ガイド使い方・特徴
- 上の入力欄に JSON を貼り付けて「Zod に変換」をクリックします。
- オブジェクトは `z.object({...})` 形式で整形され、ネストも自動で生成されます。
- 配列は要素の型を推論し、複数混在する場合は `z.union([...])` を利用します。
- コピー・リセットボタンで結果を再利用したり入力をやり直せます。
サンプル入力例と出力例
Convert JSON to Zod schema
{"id":42,"enabled":false,"labels":["alpha","beta"]}const Schema = z.object({
id: z.number(),
enabled: z.boolean(),
labels: z.array(z.string()),
});FAQよくある質問
どんなコードが出力されますか?
`import { z } from 'zod'`、`z.object({...})` のスキーマ、`z.infer` で型を取り出す1行の3点です。そのままプロジェクトに貼って、`schema.parse(data)` で検証できます。配列の要素の形が違うときは、どうなりますか?
要素を1つの型にまとめます。一部の要素にしかないキーは `.optional()` になります。種類の違う値(文字列と数値など)が混じる場合だけ、`z.union` になります。`null` はどう扱われますか?
「文字列か null」のような場合は `.nullable()` を付けます。値が `null` だけのキーは、`z.null()` になります。整数や日時は、`.int()` や `.datetime()` になりますか?
なりません。数値は、整数も小数も `z.number()`、日時の文字列も `z.string()` です。必要な絞り込みは、出力に手で足してください。空の配列は、どうなりますか?
要素の型が分からないので `z.array(z.unknown())` になります。実際のデータの型に書き換えてください。入力した JSON は送信されますか?
送信されません。変換は、すべてブラウザの中で行います。
使いどころ主な活用シーン
API レスポンスの検証コードを、すばやく作る
実際のレスポンスの JSON を貼り、出力のスキーマで `schema.parse(await res.json())` のように、受け取ったデータを検証できます。型と実行時の検証を、1回で用意する
同じスキーマから `z.infer` で TypeScript の型も取り出せるので、型定義と検証コードを二重に書かずに済みます。スキーマの出発点を作る
手でゼロから書く代わりに、サンプルの JSON から骨組みを作り、制約(文字数・範囲など)だけを手で足せます。テストデータの形を確認する
モックや、フィクスチャの JSON が、期待するスキーマに合っているかを、テストの中で検証できます。
注意点注意事項・制限
サンプル1つからの推論です
JSON に現れた値の「形」だけを見て作ります。取りうる値の範囲、列挙(enum)、文字数、メール形式などの制約は分かりません。仕様に合わせて手直ししてください。必須かどうかは、サンプルしだいです
配列の全要素にあるキーは必須、一部にしか無いキーは `.optional()` になります。実際の仕様と合っているかを確認してください。整数・日時の絞り込みは入りません
`z.number()` や `z.string()` のままです。整数に限りたいときは `.int()`、日時なら `.datetime()` などを足します。入力は、厳密な JSON だけです
コメントや末尾のカンマなど、JSON として正しくない書き方は、エラーになります。なお、JavaScript で正確に扱えない大きな整数は、丸められます。
概要このツールについて
JSONレスポンスからZodスキーマを生成
任意のJSONデータを入力として受け取り、TypeScriptエコシステムで定番のバリデーションライブラリである「Zod」のスキーマ定義コードを自動出力します。
APIから返却される動的なデータに対して、バリデーションと型安全性を同時に担保する際、Zodスキーマの手動構築は時間がかかります。本ツールを使えば、期待するJSONフォーマットを直接Zodコードに変換できるため、型安全なアプリケーションをより手軽に構築可能になります。
実行時バリデーションが必要な理由
TypeScriptの型はコンパイル時には便利ですが、外部API、フォーム入力、Webhook、設定ファイルのように実行時に入ってくるデータまでは保証できません。Zodスキーマを用意しておくと、予期しないnull、型違い、必須項目の欠落をアプリケーション境界で検出できます。
このツールは、手元のサンプルJSONからZodの初期コードを作るための補助として使えます。APIクライアント、サーバーアクション、バッチ処理の入口でバリデーションを行いたい場合に、最初のスキーマ作成時間を短縮できます。
生成後に追記するとよい制約
サンプル値からは、メールアドレス、URL、UUID、日付、最小文字数、数値範囲などの業務ルールまでは自動で判断しきれません。生成された z.string() や z.number() を確認し、必要に応じて .email()、.url()、.min()、.max()、.optional() などを追加してください。そうすることで、型定義だけでは防げない入力ミスをより早く検出できます。
おすすめリソース
このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。
このツールの関連記事
ZodでJSONバリデーションを簡略化する
TypeScriptフレンドリーなスキーマ定義ライブラリ「Zod」を使い、JSONデータのランタイムバリデーションと型生成を自動化する方法を紹介します。サンプルJSONからスキーマを作る流れも解説。
JSON SchemaとZodを相互変換する仕組み|requiredと.optional()の対応
JSON SchemaからZodスキーマを生成し、Zodのコードから逆にJSON Schemaを書き出す双方向変換ツールの実装を解説。requiredと.optional()で既定値が逆転している問題、formatや制約の対応表、コードを実行せずに解析する方法まで整理します。
JSON整形・検証の基本:APIレスポンスを読みやすく安全に確認する方法
APIレスポンスやログに含まれるJSONを整形し、構文エラーを見つけ、値の型を確認して、型生成やスキーマ化へつなげる実務的な確認手順を解説します。DevToolKitsのJSONツールを使った進め方も紹介します。
JSONエコシステム入門:整形・型生成・バリデーション・API定義を実例でつなぐ
JSONを起点にTypeScript型、Zodによる実行時バリデーション、OpenAPI定義へと展開する一連の流れを、実際のコード例でつなげて解説。型安全なAPI開発の全体像がわかります。
JSONからTypeScript型定義を自動生成する方法:実例で学ぶ変換のコツ
APIレスポンスのJSONからTypeScriptの型定義を生成する手順を、実際の変換例つきで解説。null・配列・ネストの扱いや命名のコツ、手書きとの使い分けまで紹介します。
このツールの実装解説
運営者のZenn記事 ↗作る過程で踏んだバグや設計の判断を、Zennに書いています。
