JSON to Zod スキーマコンバーター

Zodスキーマとは？

サンプル

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

import { z } from "zod";

export const RootSchema = z.object({
  id: z.number().int(),
  name: z.string(),
  email: z.string(),
  active: z.boolean(),
  roles: z.array(z.string()),
});

export type Root = z.infer<typeof RootSchema>;

{"repo":"zod","owner":{"login":"colinhacks","id":100}}

import { z } from "zod";

export const OwnerSchema = z.object({
  login: z.string(),
  id: z.number().int(),
});

export const RootSchema = z.object({
  repo: z.string(),
  owner: OwnerSchema,
});

export type Root = z.infer<typeof RootSchema>;

{"users":[{"id":1,"nick":"x"},{"id":2}]}

import { z } from "zod";

export const UserSchema = z.object({
  id: z.number().int(),
  nick: z.string().optional(),
});

export const RootSchema = z.object({
  users: z.array(UserSchema),
});

export type Root = z.infer<typeof RootSchema>;

{"items":[{"sku":"A1","discount":0.1},{"sku":"A2","discount":null}]}

import { z } from "zod";

export const ItemSchema = z.object({
  sku: z.string(),
  discount: z.number().nullable(),
});

export const RootSchema = z.object({
  items: z.array(ItemSchema),
});

export type Root = z.infer<typeof RootSchema>;

JSONをZodに変換する方法

1. 1

   JSONを貼り付ける

   JSONオブジェクト・配列・APIレスポンスを入力欄に入れてください。変換は即座に始まります。

2. 2

   出力を調整する

   ルートスキーマの名前を変更し、import行、z.infer型、exportキーワードを切り替えて、あなたのプロジェクトのスタイルに合わせてください。

3. 3

   コピーまたはダウンロード

   生成されたZodスキーマをワンクリックで取得し、検証層にそのまま貼り付けてください。

Common Use Cases

APIレスポンスの検証

サンプルのRESTやGraphQLレスポンスをZodスキーマに変換し、fetch境界で解析することで、不正なデータがアプリに漏れ込む代わりに明確なエラーで即座に失敗します。

型安全なフォームと入力

フォームやクエリ入力のスキーマを生成し、UIとハンドラー全体でz.infer型を再利用して、エンドツーエンドの型安全性を実現します。

tRPCとAIツールのスキーマ

サンプルペイロードから、tRPCプロシージャやAI構造化出力ツールの入力・出力スキーマを手書きせずにブートストラップします。

変換の仕組み

構造推論

各オブジェクトは名前付きスキーマになります。同一の形状は一度だけ宣言されて再利用されます。オブジェクトの配列はキーごとにマージされ、一部の項目に存在しないキーは.optional()になります。

正しい型マッピング

整数はz.number().int()に、小数はz.number()にマッピングされます。文字列・真偽値・nullはそれぞれz.string()・z.boolean()・z.null()にマッピングされ、プリミティブが混在する配列はz.union()になります。

TypeScript型を同梱

ルートスキーマにz.infer型エイリアスが出力されるため、スキーマが唯一の情報源であり続け、型が検証からずれることはありません。

100%クライアントサイド

解析と生成はネットワーク通信なしでブラウザ内で実行されるため、データはプライベートに保たれます。

クリーンなZodスキーマのためのヒント

ルートスキーマに名前を付ける

読みやすく自己文書化されたコードのために、デフォルトのRootではなく、UserやApiResponseのような意味のあるルート名を設定してください。

z.unknown()とユニオンを精緻化する

空または混在した配列はz.unknown()や広範なz.union()を生成します。より充実した代表的なサンプルを貼り付けてツールに正確な型を推論させ、曖昧なまま残るものを絞り込んでください。

境界で検証する

信頼できないデータが入る場所 — APIレスポンス、フォーム入力、Webhook — でsafeParse()を呼び、不正なデータがアプリケーションロジックに届く前に捕捉してください。

よくある質問