編碼與文字
JSON 轉 TypeScript
JSON 轉 TypeScript,就是把一份 JSON 範例轉成對應的 TypeScript 型別。把 JSON 貼到左邊,選 interface 還是 type alias,工具會自動寫出巢狀介面、陣列元素型別與選用欄位,直接貼進專案就能用。整個過程在瀏覽器完成,JSON 不會離開你的裝置。
JSON 轉 TypeScript 是從 JSON 範例推導 TypeScript 型別定義的做法,讓編譯器替你檢查資料結構,而不是執行時靠猜。
無論你叫它 JSON 轉 TS 產生器,還是 TypeScript 型別產生器,結果一樣:給既有資料一份可依賴的型別契約。
你能做什麼
interface 與 type 別名任選
依團隊習慣選輸出形態。巢狀物件會產生巢狀介面,陣列會產生具名元素型別 —— JSON 轉 TypeScript 的 interface 產生器會處理深度結構,不只管最外層。
辨識選用與可空欄位
範例資料比裸 schema 攜帶更多資訊:某個欄位只在一處出現會被標成選用,同一個欄位既有值又有 null,會變成可空聯合型別。
型別命名由你決定
根型別自己取名,成員可選 PascalCase 或 camelCase,縮排可選 tab 或空格、引號可選單引號或雙引號,貼進程式庫不用二次清理。
面向 API 回應與大體積
貼一份介面回應、fixture 或設定匯出即可。深層巢狀與大陣列都能處理,輸出依概念拆分型別,而不是一坨內聯字面量。
完全在瀏覽器內執行
轉換在你自己的機器上完成,不上傳、不用註冊、不要 API key,也不留存 —— 含客戶紀錄或憑證的 payload 也能放心貼上。
怎麼用
- 01
把 JSON 拿來。貼到左側編輯器,或上傳一個 .json 檔案,也可以先用內建範例看看輸出長什麼樣。
- 02
選輸出形態。interface 還是 type alias、根型別叫什麼名,命名風格、縮排和引號依你現有程式庫的習慣調一下。
- 03
拿走型別。複製到剪貼簿,或下載成 .ts 檔案,在需要這個資料形狀的地方直接 import。
關於 JSON 轉 TypeScript
JSON 轉 TypeScript 解決什麼
JSON 範例只告訴你「現在這份資料長什麼樣」,卻不告訴程式「可以假設什麼」。JSON 轉 TS 產生器把範例變成可貼進專案的型別契約。
別再靠 any 猜
一旦 fetch 回來、賦值給變數、再傳進幾層函式,`any` 就悄悄接管 —— 欄位名寫錯不再是編譯錯誤,而是線上半夜才炸的意外。從範例產生 TypeScript,讓 `response.user.email` 由編譯器把關。
巢狀物件變成具名型別
巢狀物件會各自產生具名的 interface。`billing.address` 會得到獨立的 `Address` 型別,而不是把型別硬塞進主型別裡變成一長串內聯字面量。讀起來像人寫的程式。
陣列、選用欄位與根級列表
陣列會產生具名元素型別,`BillingAddress[]` 比重複寫 `{ street: string }[]` 好讀。有的紀錄有 `nickname`、有的沒有,該屬性就會標成選用。根級陣列也會取好根型別,輸出 `RootType[]`。 產生型別前若要先比對兩份介面回應,可先打開 JSON Diff 工具。
選 interface、type 別名還是 class?
依程式庫習慣選輸出形態。本工具產生 interface 或 type alias;class 輸出尚未提供。
輸出 適合 聯合型別 執行時行為 說明 interface 可能被繼承或合併的物件形狀 否 無 JSON 資料的預設輸出 type alias 聯合型別、原始型別與單一具名形狀 是 無 欄位可能是多種型別時用 class 需要方法與執行時行為的資料 是 方法與欄位 本工具暫不產生 型別不是驗證器
產生的型別描述的是你貼上的那份範例,不是介面的真面目。型別是編譯期契約,不是執行時保證 —— 它沒法驗證網路上真正到達的資料是否仍匹配。
cast 不等於檢查
`data as User` 只是讓編譯器閉嘴。來自不受你控制的介面時,應先產生型別,再在執行時驗證。若需先清理或驗證範例,可用 JSON 格式化工具。
用 JSON 範例還是 JSON Schema?
兩條路最終都通向 TypeScript,但出發點不同。已有回應或 fixture 時,範例優先更快;已有正式描述時,schema 優先更精確 —— 有 schema 就用 schema,否則貼範例繼續做事。
來源 從何開始 精度 聯合型別 何時使用 JSON 範例 你已有的真實資料 反映範例裡出現過的內容 僅範例展示出的 探索介面、原型期、給 fixture 補型別 JSON Schema 允許形狀的正式描述 受 schema 規則約束 按宣告支援 schema 已存在且必須強制
私密、快速、免費
完全在瀏覽器內執行
轉換在本機完成,不上傳,也不留存你的 JSON 副本。
免註冊
打開頁面就能轉,沒有帳號、登入和 API key。
免安裝
不用 Node.js、不用命令列、不用建置步驟,任何有瀏覽器的機器都能用。
免費且不限量
沒有試用、沒有付費牆,範例體積也不設上限。