底層運作原理
透過專為瀏覽器環境打造、完全不呼叫 `new Function()` 或 `eval()` 的遞迴抽象語法樹(AST)驗證引擎,同時檢查您輸入的 Schema 定義與待測 JSON Payload。不像部分驗證器遇到第一個錯就中斷,本工具會遍歷整個物件樹並收集全部違規項目,附帶精確到陣列索引的 JSON 路徑(如 `$.items[2].email`)。
詳細操作步驟
在左側貼上您的 JSON Schema 規範(或先載入內建範例快速測試)。
在右側貼上要驗證的 JSON 資料負載(Payload)。
即時檢視驗證通過狀態,或逐筆查看彙整後的 `$.path` 錯誤清單與預期規則說明。
點擊「複製錯誤報告(Copy Error Report)」將完整診斷結果貼回給團隊除錯。
核心功能與效能優勢
- 完整支援核心驗證關鍵字:`required`、`type`(精確區分 `integer` 與 `number`)、`enum`、`const`、`additionalProperties`、`properties`、`items`
- 支援邏輯組合與邊界限制:`allOf` / `anyOf` / `oneOf`、`minimum` / `maximum` / `exclusiveMinimum`、`minLength` / `pattern`
- 內建常見 `format` 格式校驗:`email`、`uuid`、`date`、`date-time`、`ipv4`
- 嚴格零 `new Function()` 安全架構,通過嚴格內容安全政策(CSP),且一次收集全部錯誤而非只報第一條
- 100% 瀏覽器本地運算,未公開 API 規格書與敏感資料絕不流出
運算方法、公式與技術標準
同時透過 `JSON.parse` 檢查 Schema 與資料檔語法後,以純遞迴函式走訪 Schema 節點進行型別、數值範圍、正則與子結構校驗,並在遞迴堆疊中追蹤目前路徑(如 `$.items[2].email`)以累積完整錯誤陣列。
常見實務應用情境
- 前後端對接 API 時確認前端送出的 JSON Payload 是否完全符合後端合約 Schema
- AI / LLM 開發者驗證 Structured Outputs(結構化輸出)或 Function Calling 定義是否正確運作
- 除錯設定檔(如 `tsconfig` 或自訂設定檔)為什麼沒有通過自動化 Schema 檢查
- 測試 `oneOf` 與 `additionalProperties: false` 在複雜多型物件上的實際驗證效果
實作範例與邊界案例
Strict Object & Format Check
Plan: "enterprise" (enum: free/pro/team), seats: 0 (minimum: 1), extraField: true
$.plan (enum), $.seats (minimum), $.extraField (additionalProperties)
Reports all three distinct violations in one pass instead of stopping at the first error.
UUID & Email Format Validation
{ "id": "550e8400-e29b-41d4-a716-446655440000", "email": "ops@microdeck.tools" } Valid JSON against Schema (0 errors)
Verifies both RFC UUID v1-v8 format and basic email structure.
使用限制與精準度說明
- • 基於安全與離線隱私原則,不支援透過網路自動抓取外部遠端 `$ref` URL。
- • 尚未涵蓋極為冷門的 Draft 2020-12 進階關鍵字(例如 `$dynamicRef` 或 `unevaluatedProperties`)。
瀏覽器本地運算與隱私保障
傳統線上轉換網站會將您的文件、文字片段或影音檔案上傳至遠端伺服器。JSON Schema 結構驗證與錯誤診斷工具 完全在您的瀏覽器分頁內運行:
您的檔案與文字都在裝置本機計算,不會傳送內容至任何後端伺服器。
Microdeck 不會記錄或儲存您在工具內貼上的任何檔案或程式碼。
所有暫存結果僅存在目前分頁記憶體中,重設或關閉分頁後即刻清除。
常見問題 (FAQ)
這個工具會像 Ajv 某些模式一樣遇到第一個錯誤就停下來嗎?
不會。我們的驗證器設計為收集所有路徑的違規項目,讓您一次修完 Payload 裡所有的欄位問題。
支援檢查 `format: "uuid"` 或 `"date-time"` 嗎?
支援,內建直接校驗 `email`、`uuid`、`date`、`date-time` 與 `ipv4` 格式。
為什麼沒有提供從遠端網址載入 `$ref` 的功能?
為貫徹 100% 本地隱私與避免跨站請求外洩資訊,工具故意禁止對外部網域發出抓取請求;建議測試時先將子定義放在同份 Schema 內。
我貼上的公司內部 API Schema 與實測資料安全嗎?
絕對安全,所有驗證計算都在您的瀏覽器分頁內部離線執行,沒有任何網路上傳行為。