從 JSON 產生 Zod 驗證 Schema
0 位元組上傳將 JSON 酬載轉為型別安全的 Zod 執行期驗證器(`z.object`、`z.union`、`.nullable()`)與 `z.infer` TS 型別。
或將文字或資料檔案拖曳至此 · Ctrl V 快速貼上 · 或拖放 .json 檔案 · Ctrl V 貼上 JSON
- 100% 瀏覽器本機執行
- 自動匯出 z.infer TS 型別
- 支援 .strict() 嚴格模式
即時轉換前後預覽
{
"eventId": "evt_991",
"attempt": 1,
"payload": {
"success": true,
"tags": ["billing"]
}
}import { z } from "zod";
export const rootSchema = z.object({
eventId: z.string(),
attempt: z.number(),
payload: z.object({
success: z.boolean(),
tags: z.array(z.string()),
}),
});
export type RootSchema = z.infer<typeof rootSchema>;來源格式與目標格式規格比較: JSON → Zod 結構描述
| 規格屬性 | 來源格式:JSON | 目標格式:Zod 結構描述 |
|---|---|---|
| 結構類型 | 階層式 | 具型別程式碼 |
| 人類可讀性 | 高 | 高 |
| 支援巢狀結構 | 支援 | 支援 |
| LLM Token 效率 | 低 | 中 |
| 副檔名 | .json | .ts |
| MIME 類型 | application/json | text/typescript |
| 最適合用於 | REST/GraphQL API 接口、結構化應用程式狀態、NoSQL 文件與跨系統資料交換。 | 執行期 API 邊界驗證、tRPC/React Hook Form 表單驗證與單一來源 TypeScript 型別推導。 |
運作方式
如何在本機從 JSON 產生 Zod Schema
透過根據 JSON 範例生成的即時 Zod 驗證 Schema,保護 API 端點與表單處理程式。
- 貼上範例 JSON拖入或貼入 Webhook 酬載、設定物件或 REST JSON 回應。
- 設定 Schema 產生選項設定 Schema 名稱、匯出 z.infer 型別推導,並按需套用 z.strictObject() / .strict()。
- 複製 Zod 模組將產生的 Zod 驗證器直接貼進您的 TypeScript 專案或 tRPC 路由器。
常見問題
常見問題解答
當陣列裡部分元素缺少可選屬性時,JSON 轉 Zod 會如何處理?
僅出現於部分陣列項目的屬性會自動輸出 .optional(),而值為 null 的欄位則會加上 .nullable()。
應該在產生的 Zod Schema 中開啟「嚴格物件」模式嗎?
希望遇見未知多餘鍵時立即拋出驗證錯誤可開啟;若消費常新增無害欄位的第三方 API 建議維持關閉。
產出內容會自動附上 z.infer TypeScript 型別別名嗎?
會的。保持「匯出 z.infer TypeScript 型別」開啟即可於 Schema 下方輸出 export type ... = z.infer<typeof ...>。