.ts · text/typescript

Zod スキーマ: ランタイム JSON バリデーションスキーマ

Zod スキーマは、実行時の JSON バリデーション(`z.object`、`z.array`、`.optional()`)と `z.infer<typeof schema>` による静的 TypeScript 型導出を両立します。

クイックアンサー: Zod スキーマは、実行時の JSON バリデーション(`z.object`、`z.array`、`.optional()`)と `z.infer<typeof schema>` による静的 TypeScript 型導出を両立します。 API 境界のランタイム検証、tRPC / React Hook Form スキーマ、単一ソースからの TypeScript 型推論。

構造タイプ型付きコード
可読性高
ネスト対応対応
LLM トークン効率中
拡張子.ts
MIME タイプtext/typescript
主な用途API 境界のランタイム検証、tRPC / React Hook Form スキーマ、単一ソースからの TypeScript 型推論。

メリット

  • 非信頼 JSON を実行時に検証しつつ静的な TypeScript 型も同時に導出できる
  • 必須キー欠落や型の食い違いを分かりやすいエラーで早期検出可能
  • .strict() モードで未定義の余分なプロパティを厳格に拒否できる

注意点・トレードオフ

  • コンパイル時に消える TypeScript 素の型と比べわずかなランタイム容量が増える
  • 深い再帰スキーマでは手動での型ヒント補足が必要になる
  • strictObject 設定は API 側がフィールドを追加した際に後方互換を壊す場合がある

参考文献

Zod スキーマ をローカルで変換・整形

関連エンジニアリングガイド

関連フォーマット

全24形式を見る

Zod スキーマ に関するよくある質問

素の TypeScript インターフェースではなく Zod スキーマを生成する利点は何ですか?

TypeScript の型は実行時に消えますが、Zod は実際の受信 JSON をランタイムで検証し、同時に z.infer<typeof schema> で静的型も提供します。

JSON to Zod の「厳格な z.strictObject()」設定は何をしますか?

スキーマに未定義のキーが含まれていた場合に黙って取り除くのではなく、バリデーションエラーを発生させます。

ネストされた JSON オブジェクトや混合配列も自動変換されますか?

はい。ネスト構造に対して z.object()、z.array()、z.union()、.nullable() / .optional() を適切に出力します。