JSON をオンラインで結合

JSON の結合について

ディープマージとシャローマージの違い

シャローマージが見るのはトップレベルのキーだけです。2 つの JSON に同名のトップレベルキーがあれば、たとえその値が 20 階層あるオブジェクトでも、後ろの方がまるごと前を上書きします。ディープマージは両側がオブジェクトである限り下へ降り続け、本当に競合している葉だけを上書きします。設定ファイルの場面ではほぼ常にディープマージが必要です。既定の設定に 3 行だけ書いた環境用の上書きを重ねる場合、シャローマージだと既定の設定の同じグループにある他のキーまで消えてしまい、これがまさに「1 行変えたらブロックごと消えた」という問題の出どころです。逆に、2 つのデータがもともと対等なレコードなら、シャローマージの方が速く予測もしやすくなります。

配列が既定でまるごと置き換えられる理由

添字による結合がほぼ確実に誤りだからです。配列の添字は identity ではありません。 ["a","b","c"] と ["x"] を位置で結合すると ["x","b","c"]になりますが、これを望む人はまずいません —— ["x"] を渡した人は「この 1 項目がすべてだ」と言いたいのがほとんどでしょう。JSON Merge Patch（RFC 7386）もそう定めています：配列は 1 つの値全体として扱い、要素ごとの結合はしません。そのため本ページの既定は「後ろで上書き」で、同時に「前後を連結」と「連結後に重複除去」も用意しています。いくつかのリストをつなげたいというのも確かによくある要望ですが、それは設定の上書きとは別の作業なので、一度ご自身で選んでいただく形にしています。

null は「削除」なのか「1 つの値」なのか

ここが結合でいちばん事故が起きやすいところです。{"a": null} が「a を空にする」なのか「a というキーには触らない」なのかは、JSON 自体が定めていません。RFC 7386 は null を削除命令とみなす立場をとりますが、多くの「ディープマージ」ライブラリーはこれを普通の値として扱い、通常どおり上書きします。どちらも筋は通っていて、悪いのは既定の挙動を明示しないことです。本ページの既定はnull に既存の値を上書きさせないです。設定の結合では、その方が人の意図に近いからです。null で明示的に空にしたいときは「null による既存値の上書きを許可」にチェックを入れてください。

結合の前に、どれも正しい JSON かを確認する

結合ツールが出すエラーは、結合そのものの問題ではなく、どれか 1 つの入力がそもそも解析できないだけ、ということがよくあります。末尾のカンマ、シングルクォート、コードからコピーしたときに付いてきたコメントなどです。本ページは入力ブロックごとに解析結果とエラー位置を個別に表示するので、赤くなったブロックを直してから結合してください。入力が長く、構造を把握したり特定の行を探したりしたい場合は、JSON オンライン整形で開いてツリー表示に展開する方が、テキストエリアで括弧を数えるよりずっと速く済みます。