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 相同,讓您不必知道陣列的確切長度,就能取得一個範圍的項目。