jq プレイグラウンド
| フィルター | 説明 |
|---|---|
| ドキュメント全体を整形表示 | |
| 配列のすべての要素を反復処理 | |
| パスでネストした値を取得 | |
| 条件に一致する要素のみ残す | |
| 配列のすべての要素を変換 | |
| オブジェクトのキーを一覧表示 | |
| オブジェクトをキーと値のペアに変換 | |
| フィールドで要素をグループ化して件数を数える | |
| フィールドで配列をソート | |
| 配列の要素数を数える | |
| 行を CSV 形式に整形(生出力を有効にする) | |
| 文字列を Base64 エンコード(生出力を有効にする) | |
| すべての数値のパスを一覧表示 | |
| すべての数値を再帰的に収集 | |
| reduce で値を合計 | |
| Null 入力ですべての入力を読み取る(複数の JSON ドキュメントを試してください) |
技術的な詳細
jq プレイグラウンドの仕組み
このツールでできること
jq プレイグラウンドは、入力に合わせて本物の jq フィルターを JSON に対して実行します。jq 1.8 は WebAssembly にコンパイルされて Web Worker 内で実行されるため、エラーメッセージを含め、コマンドラインツールと完全に同じ結果になります。JSON を貼り付け、.users[] | select(.age > 30) | .name のようなフィルターを書くと、少し間を置いて出力が更新されます。オプションは jq のフラグに直接対応しています。生出力(-r)、コンパクト(-c)、slurp(-s)、null 入力(-n)、キーのソート(-S)、タブインデント(--tab)、名前付きの --arg 変数です。
主な利用シーン
シェルスクリプト、CI パイプライン、Kubernetes や AWS CLI のワンライナーに組み込む前のフィルターのプロトタイピング、大きな API レスポンスやログ行の調査、@csv による JSON から CSV への変換、map、group_by、reduce によるペイロードの整形、クリックできる例を収録した内蔵チートシートでの jq の学習に利用されています。
入力、出力、フラグ
入力は単一の JSON ドキュメントでも、NDJSON のように連結された複数のドキュメントでもかまいません。Slurp を使うとそれらが 1 つの配列にまとめられ、Null 入力では input と inputs で自分で読み取ります。各結果は 1 行ずつ出力されます。生出力は文字列を引用符なしで出力し、@csv、@tsv、@base64、@uri の出力に必要です。--arg で渡した値はフィルター内で $name として使用でき、常に文字列です。
注意点と制限
入力は 5 MB までに制限され、無限に続くフィルターでページがフリーズしないよう、実行は 10 秒後に停止されます。数値は jq の倍精度の仕様で処理されるため、2^53 を超える整数は精度が失われることがあります。ここではシェルのクォートは不要です。ターミナルではフィルターをシングルクォートで囲んでください。このプレイグラウンドは、jq のモジュール、ファイルからのインポート、環境変数に対応していません。