底層運作原理
採用符合 RFC 9535 語意且完全不使用 `eval()` 或 `new Function()` 的遞迴 AST 評估器,在您的瀏覽器內安全執行 JSONPath 查詢。從根節點 `$` 開始依序展開屬性選取、萬用字元 `[*]`、負索引 `[-1]`、陣列切片 `[start:end]`、遞迴搜尋 `..prop` 以及過濾述詞 `[?(...)]`,最後同步輸出命中數值與精確的標準方括號路徑。
詳細操作步驟
在左側輸入區貼上待查詢的 JSON 物件或陣列(無效語法會即時給出解析錯誤)。
在上方表達式欄位輸入 JSONPath 語法,例如 `$.store.book[?(@.price < 20)].title`。
即時查看命中項目數量、匹配後的 JSON 結果清單以及每筆資料對應的規範化路徑(如 `$['store']['book'][0]['title']`)。
點擊範例預設鈕快速切換常用查詢模式並複製測試結果。
核心功能與效能優勢
- 完整支援 RFC 9535 核心選擇器:`$`、`.key`、`[*]`、負索引 `[-1]`、切片 `[start:end]` 與遞迴 `..prop`
- 安全支援過濾表達式如 `[?(@.price < 20)]` 與布林存在檢查 `[?(@.inStock)]`
- 嚴格零 `eval()` / `new Function()` 架構,符合最嚴格瀏覽器 CSP 資安標準
- 同步輸出每個匹配節點的標準方括號路徑,方便回溯資料結構位置
- 100% 瀏覽器本地執行,敏感 API 回應負載絕不外傳
運算方法、公式與技術標準
輸入 JSON 經 `JSON.parse()` 驗證後,JSONPath 字串會由手寫詞法/語法解析器轉為步驟陣列(Root、Child、Wildcard、Index、Slice、Descendant、Filter),再以遞迴方式遍歷 JSON 節點並同步組裝規範化路徑字串(Normalized Path)。
常見實務應用情境
- 後端與 QA 工程師為自動化測試腳本、Postman 或 API Gateway 撰寫並驗證擷取路徑
- 從龐大的巢狀第三方 Webhook 回應或 AWS/GCP 設定檔中快速萃取出特定欄位陣列
- 除錯為何某個 `[?(@.status == 'active')]` 過濾條件沒有命中預期的物件
- 學習並驗證負索引 `[-1]` 與深度掃描 `..id` 在不同 JSON 結構中的實際行為
實作範例與邊界案例
Filter Books Under $20
$.store.books[?(@.price < 20)].title
["Browser Cryptography", "Zero-Backend Architecture", "WebAssembly Field Guide"]
Filters objects first, then extracts only the requested property.
Recursive Price Extraction
$..price
[14.5, 24, 8.99, 19.5]
Collects matching keys at any depth.
使用限制與精準度說明
- • 過濾器 `[?(...)]` 目前支援單一二元比較運算或存在性判斷,尚未支援 `&&` / `||` 複合邏輯或正則比對。
- • 若輸入的 JSON 語法本身不合法,`JSON.parse` 將先停止評估並提示修復位置。
瀏覽器本地運算與隱私保障
傳統線上轉換網站會將您的文件、文字片段或影音檔案上傳至遠端伺服器。JSONPath 查詢語法測試與過濾器 完全在您的瀏覽器分頁內運行:
您的檔案與文字都在裝置本機計算,不會傳送內容至任何後端伺服器。
Microdeck 不會記錄或儲存您在工具內貼上的任何檔案或程式碼。
所有暫存結果僅存在目前分頁記憶體中,重設或關閉分頁後即刻清除。
常見問題 (FAQ)
這個 JSONPath 測試器支援負索引或範圍切片嗎?
支援。您可以使用 `[-1]` 取得陣列最後一筆元素,或用 `[0:3]`、`[1:]` 進行標準切片選取。
為什麼輸出同時會列出像 `$['items'][2]` 這樣的路徑?
這是 RFC 9535 定義的規範化路徑(Normalized Path),能讓您精確定位每筆過濾結果原本位於 JSON 樹狀結構中的哪個索引位置。
在這裡執行過濾表達式會有 XSS 或程式碼注入風險嗎?
完全不會。本工具使用專屬的純邏輯遞迴評估器解析語法樹,完全不呼叫 JavaScript `eval()` 或 `new Function()`。
我貼上的真實客戶訂單 JSON 會傳送到網路上嗎?
不會,整個解析與匹配過程都在您本機瀏覽器中即時完成,不經任何遠端伺服器。