跳至內容
Schema 工具

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 與特殊陣列需要依照實際合約調整。

這個工具的相關文章

最新文章