JSONata 式テスター

JSONata Tester の仕組み

このツールでできること

JSONata Tester では、JSON データに対して JSONata 式を書いてリアルタイムに評価できます。JSONata は JSON 向けの軽量なクエリ／変換言語で、XML に対する XPath や XSLT に相当します。このツールは入力中にクエリ結果を即座に表示するため、複雑なデータ抽出や変換式を対話的に開発・デバッグしやすくなります。

開発者によくある利用シーン

開発者は、JSONata をネイティブにサポートする Node-RED フロー、API オーケストレーション層、サーバーレス統合プラットフォーム向けのデータ変換ルールを作る際に JSONata テスターを利用します。アプリケーションコードに埋め込む前に、JSON データの抽出・フィルタ・集計・整形を行う複雑なクエリをプロトタイピングするのに有用です。jq や JSONPath の代替として JSONata を評価するチームは、表現力の比較や構文学習のためにテスターを使います。

データ形式、型、またはバリエーション

JSONata は、パスナビゲーション（account.orders.product）、配列フィルタ（[price > 100]）、ワイルドカード降下（**.name）、文字列操作（$substring, $join）、数値集計（$sum, $average）、条件式、ユーザー定義関数（$myFunc := function）、ソート（$sort）、グルーピング、正規表現マッチングをサポートします。JSONPath と異なり、JSONata はノードを選択するだけでなくデータ構造自体を変換できるため、純粋なクエリ言語ではなく、完全なクエリ＆変換言語です。

よくある落とし穴とエッジケース

JSONata は、パスが一致しない場合にエラーではなく undefined（出力なしとして表示）を返すため、サイレントな失敗のデバッグが難しくなることがあります。JSONata の配列操作は単一要素の結果を自動的にフラット化するため、配列を返すはずの式が、1要素しか一致しない場合にスカラーを返すことがあります。この言語は jq や JSONPath ほど広く知られていないため、チームメンバーが構文に不慣れだと保守上の課題になり得ます。

コードではなくこのツールを使うべき場面

このブラウザツールを使って、Node-RED、AWS Step Functions、カスタム API などのプラットフォームにデプロイする前に、JSONata 式を対話的に開発・テストできます。本番利用では、Node.js アプリケーションに jsonata npm パッケージを直接組み込み、事前コンパイル、キャッシュ、カスタム関数登録、そしてブラウザのテスト環境では提供できない適切なエラーハンドリングを利用してください。