本文へスキップ
スキーマ変換

JSON Schema ⇄ Zod 変換

JSON Schema から Zod のスキーマを生成し、逆に Zod のコードから JSON Schema を書き出せる、双方向の変換ツールです。required と .optional()、enum、union(oneOf / anyOf)、ネストしたオブジェクト、["string", "null"] と .nullable()、additionalProperties: false と .strict()、文字列の format(email・uri・uuid・date-time)や長さ・パターン・数値の範囲の制約を、相互に対応付けます。同じファイル内の $ref(再帰を含む)は名前つきの定義に、allOf は .and() に、タプル・default・description も対応づけます。外部ファイルへの $ref や if/then など変換できない箇所は any として扱い、警告として表示します。Zod のコードは実行せずに読み取るだけです。処理はすべてブラウザ内で完結し、入力したスキーマは送信されません。

JSON のサンプルから JSON Schema を作る

サンプルの JSON を貼ると、それを表す JSON Schema(2020-12)を作ります。型・必須のキー・null 許容・format を推測し、配列の一部の要素にしかないキーは省略可能にします。

ガイド

使い方・特徴

  • 「JSON Schema → Zod」を選んでJSON Schemaを貼り付けると、`z.object({ ... })` 形式のZodスキーマと `z.infer` による型エイリアスが生成されます。
  • 「Zod → JSON Schema」を選ぶと逆方向に変換します。`import` 行や `export const user =` が付いたままでも、`z.` から始まる式を取り出して解釈します。
  • `required` に入っていないプロパティには `.optional()` が付き、逆方向では `.optional()` の無いプロパティが `required` に入ります。
  • `format: "email"` は `.email()`、`minLength` は `.min()` のように、文字列のformatと長さ制約も相互に対応付けます。
  • `$ref` や `allOf` など変換しきれない記述があった場合は、出力の下に警告として表示されます(黙って壊れた結果を返しません)。
FAQ

よくある質問

  • JSONサンプルからZodを作る「JSON to Zod」とは何が違いますか?

    入力が違います。JSON to ZodはAPIレスポンスなどの「値のサンプル」から型を推測するツールで、必須かどうかや文字列のformatは分かりません。こちらは「JSON Schema」そのものを入力とするため、requiredやenum、minLength、format:emailといった制約情報がそのままZodのチェーン(.optional() / .enum() / .min() / .email())に反映されます。手元にOpenAPIやJSON Schemaの定義がある場合はこちらが正確です。
  • requiredと.optional()はどう対応しますか?

    JSON Schemaでは「requiredの配列に列挙されていれば必須」ですが、Zodでは「.optional()が付いていなければ必須」で、既定値が逆になっています。この変換ではその違いを吸収し、JSON Schema→Zodではrequiredに無いプロパティへ.optional()を付け、Zod→JSON Schemaでは.optional()の無いプロパティをrequired配列に集めます。
  • $refを使ったスキーマは変換できますか?

    同じファイル内の$ref($defsやdefinitions、再帰を含む)は、名前つきの定義として展開します。外部ファイルへの参照や存在しないパスはその位置がz.any()になり警告が出るので、共通定義を別ファイルに分けている場合は、1つのファイルにまとめてから貼り付けてください。
  • 生成したZodをそのまま本番のバリデーションに使えますか?

    スキーマの骨組みとしては使えますが、業務ルール(メールドメインの制限、値どうしの整合性など)は元のJSON Schemaに書かれていない限り生成されません。またz.string().regex()に変換されるpatternは、JSON SchemaがECMAScript互換でない正規表現を使っている場合に挙動が変わることがあります。生成後に必ず内容を確認してください。
使いどころ

主な活用シーン

  • OpenAPI定義からフロントの型と検証を起こす

    OpenAPIのcomponents.schemasはJSON Schemaなので、そのまま貼り付ければZodスキーマとz.inferによる型が同時に手に入ります。サーバーの定義とフロントの検証がずれるのを防げます。
  • 既存のZodスキーマをAPI仕様として書き出す

    コード側で先にZodスキーマを書いている場合、逆方向の変換でJSON Schemaを生成し、OpenAPIのcomponentsやドキュメントに貼り付けられます。
  • 手書きのバリデーションをスキーマ駆動に移行する

    if文で書かれた検証を置き換えるとき、JSON Schemaがあれば出発点のZodスキーマを一気に生成できます。requiredやenumの取りこぼしが減ります。
  • AIが生成したJSON Schemaを実際に使える形にする

    LLMに書かせたJSON Schemaをそのまま貼り付けて、TypeScriptで動くZodスキーマに変換し、型と実行時検証の両方を得られます。
注意点

注意事項・制限

  • 同じファイル内の$refは展開しますが、外部参照・条件分岐は非対応です

    同じファイル内の$ref($defs・definitions・再帰)は名前つきの定義として展開し、allOfは.and()の交差型にします。外部ファイルへの$ref、if/then/else、not、patternPropertiesは非対応で、変換結果の下に警告として表示されるので、該当箇所は手で補ってください。
  • Zod→JSON Schemaは文字列としてコードを解析します

    ブラウザ内で完結させるためコードを実行せず、テキストとして解析しています。z.object / z.array / z.union / z.enum / z.literal / z.record と主要なメソッドチェーンには対応していますが、変数に切り出したスキーマの参照や、.refine() のような任意の関数はJSON Schemaに表現できないため無視されます。
  • patternの正規表現はそのまま移されます

    JSON Schemaのpatternはz.string().regex()に、逆方向ではその中身がpatternに入ります。JSON SchemaはECMAScript互換でない正規表現も許容するため、そのまま持ち込むと挙動が変わる場合があります。
  • 生成結果は必ずレビューしてください

    このツールは移行のたたき台を作るためのものです。業務ルールや値どうしの整合性チェックは元のスキーマに書かれていない限り生成されません。本番のバリデーションに使う前に内容を確認してください。

おすすめリソース

このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。

このツールの関連記事

このツールの実装解説

運営者のZenn記事 ↗

作る過程で踏んだバグや設計の判断を、Zennに書いています。

最新記事