JSON 查詢
使用 JSONPath 從 JSON 資料中精確取出您需要的值。
使用範例
從龐大的 API 回應中只取出需要的欄位
不用翻遍整份回應 JSON,用 $.data.items[*].id 這樣的路徑就能一次取出您需要的值。
篩選出符合條件的項目
使用 $.products[?(@.price<10000)] 這樣的篩選表達式,就能挑出符合價格、庫存等條件的項目。
在巢狀結構中到處尋找特定的鍵
遞迴搜尋語法 $..price 可以找出文件中任何深度、任何位置、名稱相同的所有鍵。
取得陣列中的最後一個項目
使用 $.orders[-1:],從不斷增長的記錄或訂單陣列中取出最新的一筆,不必計算其中有多少項目。
一次擷取多個特定欄位
像 $.user['name','email','id'] 這樣的聯集表達式,只會從物件中回傳這三個欄位,略過龐大使用者記錄中的其他所有內容。
檢查不熟悉的 API 回傳內容的結構
不確定某個欄位在您從未見過的回應中巢狀有多深?先以 $..fieldName 在任何位置找出它,等看到它所在的位置後,再縮小到確切的路徑。
常見問題
我輸入的 JSON 和表達式會傳送到伺服器嗎?
不會。查詢完全在您的瀏覽器中執行,您輸入的內容不會傳送到任何伺服器。
我記不住 JSONPath 語法。
常用模式如下:$ 代表整份文件、.key 代表特定的鍵、[*] 代表陣列中的每個項目、[0] 代表第一個項目、[?(@.price<10)] 篩選符合條件的項目、$..key 則是在任何深度尋找該名稱的所有鍵。
我的結果是空的,為什麼?
這可能代表路徑沒有指向任何實際資料,也可能是表達式有語法錯誤——兩種情況都會顯示空結果。可以試著一步步縮短路徑,看看在哪個地方開始找不到符合項目。
查詢結果一定是陣列嗎?
是的。JSONPath 會把所有符合的值收集成一個陣列,即使只符合一個值,也會得到長度為 1 的陣列。
這是 JSONPath、JMESPath 還是 jq 語法?
是 JSONPath,以 jsonpath-plus 函式庫求值。它支援標準的 $、.、[*]、[n] 與 $..key 語法,以及篩選表達式([?(@.price<10)])與指令碼表達式等擴充——但它與使用不同運算子的 jq 或 JMESPath 查詢語法不相容。
可以依多個條件篩選陣列嗎?
可以——在篩選表達式中以 && 或 || 結合條件,例如 $.products[?(@.price<100 && @.inStock==true)],以比對既便宜又有庫存的項目。
路徑支援負的陣列索引或切片嗎?
支援。[-1] 代表最後一個元素,而像 [1:3] 或 [-2:] 這樣的切片語法,運作方式與 Python 相同,讓您不必知道陣列的確切長度,就能取得一個範圍的項目。