JSON 轉 Zod Schema
由 JSON 範例產生 Zod 結構描述。輸出包含 import { z } from 'zod'、z.object({...}) 結構描述,以及用 z.infer 取出型別的一行,可直接貼上,並以 schema.parse(data) 驗證 API 回應等資料。陣列元素的形狀不同時會合併成一個,只有部分元素才有的鍵會成為 .optional(),「字串或 null」這類值會成為 .nullable()。空陣列為 z.array(z.unknown())。數字不論整數或小數都是 z.number(),日期字串也是 z.string(),因此 .int()、.datetime(),以及長度與範圍的限制請自行加上。這是由單一範例推論的結果。所有處理都在瀏覽器內完成,JSON 不會被傳送。
其他驗證器:Valibot 與 JSON Schema
由同一份 JSON 產生 Valibot 結構或 JSON Schema(draft 2020-12)。陣列元素會合併,只出現在部分物件的鍵會變成選填,並套用上方的字串格式與根名稱選項。
指南使用方式與特色
- 將 JSON 貼到輸入框後點擊「轉換成 Zod」。
- 物件會整理成 `z.object({...})` 區塊,巢狀結構也會自動生成。
- 陣列會推斷元素型別;若混合多種型別則使用 `z.union([...])`。
- 可以用複製或清除按鈕來重複利用或重新開始。
範例輸入與輸出範例
Convert JSON to Zod schema
{"id":42,"enabled":false,"labels":["alpha","beta"]}const Schema = z.object({
id: z.number(),
enabled: z.boolean(),
labels: z.array(z.string()),
});FAQ常見問題
會輸出什麼程式碼?
包含三部分:`import { z } from 'zod'`、`z.object({...})` 結構描述,以及用 `z.infer` 取出型別的一行。可直接貼進專案,用 `schema.parse(data)` 驗證。陣列元素的形狀不同時會怎樣?
會合併成一個型別。只有部分元素才有的鍵會變成 `.optional()`。只有在值的種類不同(例如字串與數字)時,才會使用 `z.union`。`null` 如何處理?
「字串或 null」這類情況會加上 `.nullable()`。值只有 `null` 的鍵會成為 `z.null()`。整數或日期會變成 `.int()`、`.datetime()` 嗎?
不會。數字不論整數或小數都是 `z.number()`,日期字串也是 `z.string()`。需要的限制請自行加到輸出中。空陣列會怎樣?
因為無法得知元素型別,會變成 `z.array(z.unknown())`。請改成實際資料的型別。輸入的 JSON 會被傳送嗎?
不會。轉換完全在瀏覽器內進行。
使用情境常見的使用情境
起草表單驗證
從後端範例產生 Zod 結構描述,立即放進前端驗證邏輯。驗證模擬資料
用 Zod 解析本機的模擬 JSON,在執行時找出非預期的欄位或結構。分享結構描述片段
複製產生的片段,在不同函式庫間重複使用,讓執行時檢查與型別保持一致。
注意注意事項與限制
是從單一範例推論的
只看 JSON 中值的「形狀」,無法得知值的範圍、列舉(enum)、長度、電子郵件等格式限制。請依規格調整。是否必填取決於範例
陣列所有元素都有的鍵是必填,只有部分元素才有的鍵會成為 `.optional()`。請確認是否符合實際規格。不會加入整數或日期的限制
維持單純的 `z.number()` 與 `z.string()`。需要時請自行加上 `.int()` 或 `.datetime()`。輸入必須是嚴格的 JSON
註解、結尾逗號等非 JSON 的寫法會造成錯誤。JavaScript 無法精確表示的大整數會被四捨五入。
簡介關於此工具
JSON 轉 Zod Schema 產生器
從 JSON 範例產生 Zod schema,協助建立 runtime validation。適合檢查外部 API、表單、webhook 或 storage 輸入資料的結構。
常見情境
- 驗證外部 API:用實際回應建立 schema 初稿。
- 保護資料邊界:資料進入應用前先確認格式。
- 準備測試資料:以 schema 文件化預期 payload。
產生結果是根據範例推論。optional、nullable、enum 與特殊陣列需要依照實際合約調整。
這個工具的相關文章
使用 Zod 簡化 JSON 驗證
介紹如何使用 TypeScript 友善的結構定義函式庫「Zod」,從範例 JSON 產生 schema,自動化 JSON 資料的執行期驗證與型別生成,並說明型別如何被推斷。
JSON Schema 與 Zod 雙向轉換的原理|required 與 .optional() 的對應
解析雙向轉換器的實作:把 JSON Schema 轉成 Zod 結構定義,也把 Zod 程式碼轉回 JSON Schema。內容涵蓋 required 與 .optional() 預設值相反的陷阱、限制條件對照表,以及不執行程式碼就完成剖析的做法。
JSON 格式化與驗證:安全檢查 API 回應的方法
了解如何格式化 JSON、找出語法錯誤、確認值的型別,並將 API 回應延伸成 TypeScript 型別、Zod Schema 或 OpenAPI 文件,整理出實務上的完整流程。
JSON 生態系統入門:用實例串起格式化、型別生成、驗證與 API 定義
以一個 API 回應為例,用實際程式碼串起格式化、TypeScript 型別、Zod 執行期驗證與 OpenAPI 定義,讓你看清型別安全 API 開發的全貌。
如何從 JSON 生成 TypeScript 型別:用實例學會轉換訣竅
將 API 回應的 JSON 轉換成型別安全的 TypeScript 介面,附實際轉換範例,涵蓋 null、陣列、巢狀、命名訣竅與手動微調,適合為既有 API 快速補上型別。
