TypeScript → Zod スキーマ
TypeScriptのinterfaceとtype宣言をZodバリデーションスキーマに即座に変換。Union型・省略可能フィールド・配列・enum・ネストオブジェクト・型参照に対応。無料、ブラウザ内で処理。
- ブラウザ内で処理
- ツールの入力を ZeroTool のサーバーにアップロードしません
- 無料 · 登録不要
WeChat でスキャンしてシェア
例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。
対応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)だけで、コードの内容は含みません。