作業メモ
JSON差分を見る前に整えるポイント
JSON差分は、整形や型の前提がずれていると変更点が多く見えます。まず構文と見た目を整え、次に値の意味を分けて確認します。
構文エラーと意味の差分を分ける
差分ツールへ貼る前に、JSONとして読めるか、比較したい単位が合っているかを確認します。
キー順だけでは差分にしない
オブジェクトのキー順が違うだけなら、変更点として扱うべきかを先に決めます。
配列順は意味を持つことがある
配列の並び替えは、同じ要素でも差分として出るため、比較前に順序の意味を確認します。
次にやること
1. まずJSONとして読める状態にする
コメント、末尾カンマ、引用符抜けなどを先に切り分けます。
- JSON整形
構文エラーの有無と整形結果を確認します。
- JSONLバリデーター
ログが1行1JSON形式ならこちらで行単位に見ます。
2. 比較したい範囲を絞る
レスポンス全体ではなく、必要な配列やオブジェクトだけを取り出して確認します。
- JSONPath・JMESPathテスター
比較対象の値や配列を抽出します。
- JSON→CSV
表として比較したい配列をCSVへ変換します。
3. 差分を見て変更の種類を分ける
追加、削除、変更を分け、型や配列順の差を確認します。
詰まりやすい場面
- APIレスポンスの変更点を見たいが、差分が多すぎるとき
- null、空文字、数値と文字列の違いを見落としたくないとき
- 設定ファイルの変更レビュー前に、整形と比較順をそろえたいとき
まず開くツール
各段階で最初に開くものだけを並べています。
必要なら見るページ
用語や周辺ツールが必要なときだけ使います。
- データ変換・開発カテゴリ
JSON、CSV、抽出、ハッシュなどの周辺ツールを見たいとき。