jq 線上工具
有效
JSON 輸入
輸出
Loading editor...
Loading editor...
| 篩選器 | 說明 |
|---|---|
| 格式化輸出整份文件 | |
| 逐一處理陣列的每個元素 | |
| 依路徑讀取巢狀值 | |
| 僅保留符合條件的元素 | |
| 轉換陣列的每個元素 | |
| 列出物件的鍵 | |
| 將物件轉換為鍵/值配對 | |
| 依欄位將元素分組並計數 | |
| 依欄位排序陣列 | |
| 計算陣列元素數量 | |
| 將資料列格式化為 CSV(需啟用「原始輸出」) | |
| 將字串進行 Base64 編碼(需啟用「原始輸出」) | |
| 列出所有數值的路徑 | |
| 遞迴收集所有數字 | |
| 使用 reduce 加總數值 | |
| 使用空輸入讀取所有輸入(可嘗試多份 JSON 文件) |
技術細節
jq 線上工具的運作方式
工具的功能
jq 線上工具會在你輸入時對 JSON 執行真正的 jq 篩選器。jq 1.8 被編譯為 WebAssembly 並在 Web Worker 中執行,因此結果(包括錯誤訊息)與命令列工具完全一致。貼上 JSON,撰寫篩選器,例如 .users[] | select(.age > 30) | .name,稍作停頓後輸出就會更新。選項直接對應 jq 旗標:原始輸出 (-r)、精簡 (-c)、slurp (-s)、空輸入 (-n)、排序鍵 (-S)、Tab 縮排 (--tab) 以及具名的 --arg 變數。
常見使用情境
開發者用它在將篩選器放入 shell 指令碼、CI 流程以及 Kubernetes 或 AWS CLI 單行指令之前進行原型驗證,探索大型 API 回應和日誌行,使用 @csv 將 JSON 轉換為 CSV,使用 map、group_by 和 reduce 重塑資料,並透過內建的可點擊範例速查表學習 jq。
輸入、輸出和旗標
輸入可以是單一 JSON 文件,也可以是多份串接的文件(如 NDJSON);使用 Slurp 時它們會被包成一個陣列,使用空輸入時則透過 input 和 inputs 自行讀取。每個結果單獨佔一行輸出。原始輸出會不帶引號地列印字串,這對於 @csv、@tsv、@base64 和 @uri 輸出是必需的。透過 --arg 傳入的值在篩選器中以 $name 的形式使用,並且一律是字串。
陷阱與限制
輸入限制為 5 MB,執行 10 秒後會被停止,以免無限迴圈的篩選器凍結頁面。數字依 jq 的雙精度語意處理,因此超過 2^53 的整數可能遺失精度。這裡不需要 shell 引號處理:在終端機中請用單引號包住篩選器。此線上工具不支援 jq 模組、從檔案匯入或環境變數。