從 JSON 產生 Zod 驗證 Schema

0 位元組上傳

將 JSON 酬載轉為型別安全的 Zod 執行期驗證器(`z.object`、`z.union`、`.nullable()`)與 `z.infer` TS 型別。

100% 用戶端本機執行 — 可在 Network 分頁驗證 0 位元組上傳在 Network 面板確認 0 位元組傳送

或將文字或資料檔案拖曳至此 · Ctrl V 快速貼上 · 或拖放 .json 檔案 · Ctrl V 貼上 JSON
  • 100% 瀏覽器本機執行
  • 自動匯出 z.infer TS 型別
  • 支援 .strict() 嚴格模式

即時轉換前後預覽

轉換前(輸入)webhook.json
{
  "eventId": "evt_991",
  "attempt": 1,
  "payload": {
    "success": true,
    "tags": ["billing"]
  }
}
轉換後(輸出).ts
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/jsontext/typescript
最適合用於REST/GraphQL API 接口、結構化應用程式狀態、NoSQL 文件與跨系統資料交換。執行期 API 邊界驗證、tRPC/React Hook Form 表單驗證與單一來源 TypeScript 型別推導。

運作方式

如何在本機從 JSON 產生 Zod Schema

透過根據 JSON 範例生成的即時 Zod 驗證 Schema,保護 API 端點與表單處理程式。

  1. 貼上範例 JSON拖入或貼入 Webhook 酬載、設定物件或 REST JSON 回應。
  2. 設定 Schema 產生選項設定 Schema 名稱、匯出 z.infer 型別推導,並按需套用 z.strictObject() / .strict()。
  3. 複製 Zod 模組將產生的 Zod 驗證器直接貼進您的 TypeScript 專案或 tRPC 路由器。

常見問題

常見問題解答

當陣列裡部分元素缺少可選屬性時,JSON 轉 Zod 會如何處理?

僅出現於部分陣列項目的屬性會自動輸出 .optional(),而值為 null 的欄位則會加上 .nullable()。

應該在產生的 Zod Schema 中開啟「嚴格物件」模式嗎?

希望遇見未知多餘鍵時立即拋出驗證錯誤可開啟;若消費常新增無害欄位的第三方 API 建議維持關閉。

產出內容會自動附上 z.infer TypeScript 型別別名嗎?

會的。保持「匯出 z.infer TypeScript 型別」開啟即可於 Schema 下方輸出 export type ... = z.infer<typeof ...>。