TypeScript → Zod スキーマ

TypeScriptのinterfaceとtype宣言をZodバリデーションスキーマに即座に変換。Union型・省略可能フィールド・配列・enum・ネストオブジェクト・型参照に対応。無料、ブラウザ内で処理。

  • ブラウザ内で処理
  • ツールの入力を ZeroTool のサーバーにアップロードしません
  • 無料 · 登録不要
入力を Address、User、Status の宣言に置き換え、すぐに生成します。
TypeScript、Zod 出力、ハイライト、ステータスを消去します。ツール内で Ctrl/⌘+L を押しても同じ操作になります。
interface、type、enum 宣言を入力します。入力停止から 300 ミリ秒後に生成します。解析エラー時は出力を消去してエラーを表示します。class とジェネリック型定義は対象外です。
Zod スキーマ出力
import と推論された型を含む Zod 出力を全文コピーします。出力が空の場合はコピーしません。

TypeScript を入力するかサンプルを読み込むと、Zod スキーマを生成します。

例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。

対応TypeScript機能

  • 基本型:string、number、boolean、null、undefined、any、unknown、void、never、bigint、symbol
  • 省略可能プロパティ:prop?: type → .optional()
  • Union型:A | B → z.union([A, B])
  • 文字列enum:"a" | "b" | "c" → z.enum(["a", "b", "c"])
  • 配列:T[] / Array<T> → z.array(T)
  • ネストオブジェクト:インラインオブジェクト型 → z.object({})
  • 相互参照:宣言済み型間の参照 → Schemaの定数
  • readonly:readonly修飾子を受け入れ、変換時に取り除きます(読み取り専用の型が必要なら .readonly() を追加)
  • ユーティリティ型:Partial<T>、Record<K, V>、Promise<T>
  • 交差型:A & B → z.intersection(A, B)
  • タプル:[A, B] → z.tuple([A, B])
  • リテラル型:"value"、42、true → z.literal()
  • extends:interface Admin extends Base → BaseSchema.extend({ ... })。2 つ目の基底型は .extend(OtherSchema.shape) を追加します。基底型がオブジェクトのスキーマでない場合(交差型の別名など)は z.intersection(BaseSchema, z.object({ ... })) です。入力にない基底型は通常の z.object() にコメントを付けます。
  • インデックスシグネチャ:他のプロパティと並ぶ [key: string]: V → .catchall(V)(余分なキーを検証して残す)。インデックスシグネチャだけなら z.record(z.string(), V)。JSON を解析したオブジェクトのキーは文字列なので、キーは常に z.string() です。
  • enum 宣言:文字列 enum → 値の z.enum()。数値や混在のメンバー(0 または直前の数値から自動採番)→ z.literal() の z.union()。const enum、declare enum も同じです。1 << 2 のような計算値を含む enum は全体を z.unknown() にしてコメントを付けます。
  • 宣言順と再帰:入力の順序に関係なく、依存先のスキーマから出力します。循環を閉じる参照は z.lazy(() => NameSchema) になり、循環に含まれる型は元の宣言を書き出して z.ZodType<Name> の型注釈を付けます(Zod のドキュメントにある再帰型の書き方)。出力は TypeScript 5.9 の strict モードでコンパイルし、Zod 3.25 と Zod 4 で読み込んで確認しています。

サンプル

以下のTypeScriptを入力すると:

interface Address {
street: string;
city: string;
zipCode?: string;
}

export interface User {
id: number;
name: string;
role: "admin" | "user" | "guest";
age?: number;
isActive: boolean;
tags: string[];
address: Address;
}

export type Status = "active" | "inactive" | "pending";

このように生成されます:

import { z } from "zod";

export const AddressSchema = z.object({
street: z.string(),
city: z.string(),
zipCode: z.string().optional(),
});
export type Address = z.infer<typeof AddressSchema>;

export const UserSchema = z.object({
id: z.number(),
name: z.string(),
role: z.enum(["admin", "user", "guest"]),
age: z.number().optional(),
isActive: z.boolean(),
tags: z.array(z.string()),
address: AddressSchema,
});
export type User = z.infer<typeof UserSchema>;

export const StatusSchema = z.enum(["active", "inactive", "pending"]);
export type Status = z.infer<typeof StatusSchema>;

例:LINE Messaging API の Webhook イベント

LINE が公開している OpenAPI 定義(line/line-openapi の webhook.yml)では、すべての Webhook イベントに type、timestamp、mode、webhookEventId、deliveryContext が必須で、mode は active か standby、deliveryContext.isRedelivery は真偽値です。メッセージイベントはこれに replyToken と message を加え、テキストメッセージでは id、text、quoteToken が必須です。共通部分を基底の interface にして extends で書くと、次のようになります。

type EventMode = "active" | "standby";

interface DeliveryContext {
isRedelivery: boolean;
}

interface WebhookEvent {
type: string;
timestamp: number;
mode: EventMode;
webhookEventId: string;
deliveryContext: DeliveryContext;
}

interface TextMessageEvent extends WebhookEvent {
type: "message";
replyToken?: string;
source?: { type: "user"; userId?: string };
message: { type: "text"; id: string; text: string; quoteToken: string };
}

生成結果:

import { z } from "zod";

export const EventModeSchema = z.enum(["active", "standby"]);
export type EventMode = z.infer<typeof EventModeSchema>;

export const DeliveryContextSchema = z.object({
isRedelivery: z.boolean(),
});
export type DeliveryContext = z.infer<typeof DeliveryContextSchema>;

export const WebhookEventSchema = z.object({
type: z.string(),
timestamp: z.number(),
mode: EventModeSchema,
webhookEventId: z.string(),
deliveryContext: DeliveryContextSchema,
});
export type WebhookEvent = z.infer<typeof WebhookEventSchema>;

export const TextMessageEventSchema = WebhookEventSchema.extend({
type: z.literal("message"),
replyToken: z.string().optional(),
source: z.object({
    type: z.literal("user"),
    userId: z.string().optional(),
  }).optional(),
message: z.object({
    type: z.literal("text"),
    id: z.string(),
    text: z.string(),
    quoteToken: z.string(),
  }),
});
export type TextMessageEvent = z.infer<typeof TextMessageEventSchema>;

宣言の順番を入れ替えても、依存先の EventModeSchema から順に出力されます。.extend() は同じキーを上書きするため、type は基底の z.string() ではなく z.literal("message") で検証されます。mode が paused のデータや type が follow のデータは失敗します。

上の interface に書かなかった markAsReadToken(webhook.yml では省略可能なプロパティ)を含むメッセージも検証は通りますが、Zod はスキーマにないキーを既定で取り除くため、parse() の結果からは消えます。パース後のオブジェクトは受け取ったボディと同じではないので、元のデータが必要な処理には生のボディを使ってください。値(ID やトークン)はこのページ用の例です。

例:会員登録フォーム

入力:

interface SignupForm {
email: string;
password: string;
nickname?: string;
referrer: string | null;
age?: number | undefined;
plan: "free" | "pro";
}

出力:

import { z } from "zod";

export const SignupFormSchema = z.object({
email: z.string(),
password: z.string(),
nickname: z.string().optional(),
referrer: z.union([z.string(), z.null()]),
age: z.union([z.number(), z.undefined()]).optional(),
plan: z.enum(["free", "pro"]),
});
export type SignupForm = z.infer<typeof SignupFormSchema>;

生成したスキーマで zod 3.25 を使い 3 つのデータを検証した結果:

SignupFormSchema.safeParse({ email: "not-an-email", password: "1", referrer: null, plan: "pro" })
// success: true  (型は合っている。形式のルールはまだない)

SignupFormSchema.safeParse({ email: "a@example.com", password: "x", plan: "free" })
// referrer: Invalid input  (string | null はキー必須で、省略できない)

SignupFormSchema.safeParse({ email: "a@example.com", password: "x", referrer: "ad", plan: "team" })
// plan: Invalid enum value. Expected 'free' | 'pro', received 'team'

null・undefined・省略可能の違い

  • prop?: T は .optional() になります。キーがなくてもかまいません。
  • T | null は z.union([T, z.null()])、つまり T.nullable() と同じです。キーは必須で、値に null を許します。referrer のないデータは失敗します。
  • prop?: T | null は z.union([T, z.null()]).optional() になります。キーがなくても値が null でもよく、T.nullish() と同じ意味です。

日本語の名前と全角コロン

プロパティ名と型名は TypeScript の識別子の規則で読むので、日本語をそのまま書けます。IME で入力した全角コロン : は、文字列リテラルの外では半角の : として読みます。クォートなしの 氏名 と、全角コロンを含む次の interface では:

interface Member {
id: string;
氏名: string;
"フリガナ": string;
age:number;
}
import { z } from "zod";

export const MemberSchema = z.object({
id: z.string(),
氏名: z.string(),
"フリガナ": z.string(),
age: z.number(),
});
export type Member = z.infer<typeof MemberSchema>;

4 項目すべてが残り、氏名 はそのままプロパティ名に、クォートで囲んだ "フリガナ" はクォート付きで出力されます。入力全体を NFKC で正規化しないのは、文字列リテラル型まで変わってしまうためです("ホッカイドウ" が "ホッカイドウ" になります)。型名も日本語で書け、interface 会員 は 会員Schema になります。

コロンを書き忘れると、そのプロパティを読み飛ばさず、位置付きのエラーになります。入力:

interface 会員 {
id: string;
氏名 string;
}

ステータスには 解析エラー:3 行 3 列:「氏名」の後に「:」がありません。 と表示され、出力は消えます。列は文字単位で数えます。その他の構文エラーは英語のままで、パーサーが予期しなかった最初のトークンだけを示します。閉じ括弧のない interface A { a: string は Expected "}" got ""、const 文だけの入力は「interface または type 宣言が見つかりません。」です。

TypeScript では書けないルールを足す

TypeScript の型には形式や範囲がないため、上の 1 件目は不正なメールアドレスと 1 文字のパスワードでも通ります。生成後に制約を足します:

export const SignupFormSchema = z.object({
email: z.string().email(),
password: z.string().min(8),
nickname: z.string().max(20).optional(),
referrer: z.string().nullable(),
age: z.number().int().min(13).optional(),
plan: z.enum(["free", "pro"]),
});

生成した z.infer の型を唯一の定義にして元の interface は消すと、両者がずれていくことを防げます。

制限事項

宣言の読み取りには TypeScript コンパイラではなく独自の小さなパーサーを使うため、別ファイルの型は解決せず、型チェックもしません。使う前に次の点を確認してください。

  • 宣言のない名前は z.unknown() になります。Date や import した型など、入力で宣言していない型は z.unknown() /* Name */ と出力されます。z.date() や対応するスキーマに置き換えてください。宣言のない基底型は通常の z.object() にコメント /* extends Name: not declared in the input */ を付けます。
  • enum は値をコピーします。スキーマが検証するのは enum の値("RED"、0)で、実行時の enum オブジェクトではありません。enum を import できるなら z.nativeEnum(Color)(Zod 3)や z.enum(Color)(Zod 4)でも同じです。
  • インデックスシグネチャのキーは常に z.string() です。.catchall() と併用すると、宣言済みのプロパティも自身のスキーマに合う必要があります。
  • リテラルキーの Record(Record<"read" | "write", boolean>)は z.record(z.enum(["read", "write"]), z.boolean()) になります。Zod 4 は TypeScript と同じく両方のキーを要求し、Zod 3 は片方だけでも通します。
  • 名前の Unicode エスケープは解釈しません。\u0061: string は a ではなく u0061 というプロパティになります。
  • 全角で読むのはコロンだけです。全角の疑問符などは未知の文字として読み飛ばすため、age?: number は省略可能にならず age: z.number() になります。
  • 変換しないもの:ジェネリックの型パラメーター、class、メソッド・get / set アクセサー・呼び出しシグネチャ・コンストラクトシグネチャ(読み飛ばし)、Mapped Types と Conditional Types、keyof、typeof。テンプレートリテラル型は z.string() になります。

FAQ

どのようなTypeScript構文をサポートしていますか?

interfaceとtype alias宣言をサポートし、基本型(string、number、boolean、null、undefined、any、unknown)、省略可能プロパティ(?)、Union型(A | B)、文字列enum(リテラルUnion)、enum宣言、extends、インデックスシグネチャ、再帰型、配列(T[]、Array<T>)、インラインで書いたネストしたオブジェクト型、宣言済み型間の相互参照、Partial<T>・Record<K, V>・Array<T>・Promise<T>などのユーティリティ型に対応しています。

型間の相互参照はどのように処理されますか?

入力に複数のinterfaceまたはtype aliasが宣言されている場合、宣言済み型名への参照は対応するSchemaの定数に変換されます。例えばAddress型のフィールドはAddressSchemaになります。入力で宣言されていない型はz.unknown()(コメント付き)になります。

生成されるスキーマはどのZodバージョンに対応していますか?

出力にはZod 3とZod 4の両方にあるz.object()、z.string()、z.union()、z.enum()、z.array()、.optional()、z.literal()、z.record(キー, 値)、.extend()、.shape、.catchall()、z.lazy()、z.ZodType、z.infer<>などのAPIだけを使います。Zod 4は値だけのz.record()を受け付けないため、Recordには常にキーのスキーマを書きます。Promise<T>から生成するz.promise()はZod 4で非推奨です。

文字列Union型はどのように変換されますか?

文字列リテラルのUnion(例:"admin" | "user" | "guest")は簡潔にするためz.enum(["admin", "user", "guest"])に自動変換されます。混合Union(例:string | null)はz.union([z.string(), z.null()])を使用します。

TypeScriptのclassやジェネリック型定義は変換できますか?

できません。class宣言は読み飛ばすため、classだけの入力では「interface または type 宣言が見つかりません。」と表示されます。宣言した型自身の型パラメーターは展開しません。interface Box<T> { value: T } の value は z.unknown() /* T */ になります。具体的な型に適用されたユーティリティ型(Array<string>、Record<string, number>)は変換できます。

コードはサーバーに送信されますか?

いいえ。パーサーとZod生成処理はこのブラウザのタブ内で動き、コードをサーバーに送信することも、ブラウザのストレージに保存することもありません。ページのアクセス解析が記録するのは、入力を編集してフォーカスを外したときと「サンプル」を押したときの利用イベント(ツール名と動作 generate)だけで、コードの内容は含みません。