JSON マージ

関連おすすめ

JSONマージ（JSON Merge）とは？

ユースケース

• 複数のマイクロサービスAPIレスポンスをフロントエンド用の統一JSON構造にマージ
• base/dev/prodなど多層の設定ファイルを集約し、環境別に上書きして最終設定を生成
• 複数のi18n翻訳ファイルを言語ごとにマージ・重複除去・補完して完全な辞書を作成
• 複数のモックデータ配列やページネーションAPIレスポンスを完全なデータセットに結合
• フロントエンドコンポーネントのデフォルト設定＋ユーザーカスタム設定＋リモートA/Bテスト設定をマージ
• データ移行時に複数のソースシステムのJSONエクスポートファイルをマージし、下流フォーマットに統一

使い方

1. マージする2〜N個のJSONを左側の入力欄に順番に貼り付け（デフォルトは2つ）、「+」をクリックして入力欄を追加します。
2. ツールバーのドロップダウンでマージ戦略を選択します：ディープマージ（Deep）/シャローマージ（Shallow）/配列連結（Array Concat）/配列上書き（Array Replace）。
3. 「マージ」ボタンをクリックすると、右側の出力欄にマージ後のフォーマット済み結果が表示されます。入力に構文エラーがある場合は具体的な行番号とエラーメッセージが表示されます。
4. 結果に問題がなければ「コピー」をクリックしてマージ結果をクリップボードにコピーするか、「ダウンロード」をクリックしてmerged.jsonファイルとして保存し、フォーマットやSchemaバリデーションなどの後続処理を行ってください。

特徴

• 4種類のマージ戦略：ディープマージ/シャローマージ/配列連結/配列上書きをワンクリックで切り替え可能。さまざまなビジネスシナリオに対応します。
• 2からN個のJSONに対応：デフォルトで2つの入力欄があり、「+」ボタンで入力欄を動的に追加してマルチソース集約に柔軟に対応可能。
• 深い再帰マージ：多階層にネストしたオブジェクトをインテリジェントに処理し、リーフノードの衝突は指定された戦略に従って処理。すべての有効なフィールドを保持します。
• 柔軟なコンフリクト解決：トップレベルの衝突は選択した戦略で実行。ネストオブジェクトの衝突は深い階層までマージ。配列の衝突はarrayConcat/arrayReplaceで区別して処理します。
• 統一フォーマットで出力：マージ結果は2スペースインデントで表示され、人によるレビューや下流ツールへの直接コピーが容易です。
• リアルタイムマージ：貼り付け後に「マージ」ボタンをクリックすると即座に結果を取得。エラー時は具体的なJSONの行番号とエラーメッセージを表示します。
• ローカル処理でプライバシー保護：解析、マージ、フォーマットはすべてブラウザのローカルで実行され、入力内容が外部サーバーに送信されることはありません。
• 下流ツールとシームレス連携：マージ結果をワンクリックでJSONフォーマッター、Schemaバリデーション、コード生成などのツールにコピーして後続処理を行えます。

コード例

// npm install lodash.merge
import merge from 'lodash.merge';

const a = { user: { name: 'Alice', age: 28 }, tags: ['admin'] };
const b = { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] };

// ディープマージ: ネストしたオブジェクトを再帰的にマージし、リーフノードは後入力が前の値を上書き
const deep = merge({}, a, b);
console.log(deep);
// => { user: { name: 'Alice', age: 29, email: 'a@x.com' }, tags: ['admin', 'editor'] }

// シャローマージ: トップレベルのキーを全体的に上書きし、ネストには入らない
const shallow = Object.assign({}, a, b);
console.log(shallow);
// => { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] }

# pip install mergedeep
from mergedeep import merge

a = {"user": {"name": "Alice", "age": 28}, "tags": ["admin"]}
b = {"user": {"email": "a@x.com", "age": 29}, "tags": ["editor"]}

# ディープマージ
result = merge(a, b)
print(result)
# => {'user': {'name': 'Alice', 'age': 29, 'email': 'a@x.com'}, 'tags': ['admin', 'editor']}

# 注意: mergedeepはデフォルトで配列を連結し、文字列/数値は上書きします
# 配列を上書きしたい場合は strategy='override' を指定

# 複数のJSON配列を1つの長い配列にマージ
jq -s 'add' a.json b.json c.json

# 複数のJSONオブジェクトを再帰的にマージ (jq 1.6+)
jq -s 'reduce .[] as $item ({}; . * $item)' a.json b.json

# シャローマージ: bのトップレベルキーをaに上書き
jq -s '.[0] * .[1]' a.json b.json

# 配列をマージ後、重複を除去したidフィールドのみを保持
jq -s '[.[].items[]] | unique_by(.id)' a.json b.json

よくある質問

トラブルシューティング

用語集

JSON Merge

2つ以上のJSONオブジェクトを指定されたルールに従って1つの新しいオブジェクトに結合する操作。核心的な難しさは「キー名が衝突したときの解決戦略」にあります。

Deep Merge / ディープマージ

ネストされたオブジェクトを再帰的にたどり、リーフノードごとに個別マージする戦略。両辺がプレーンオブジェクトの場合は再帰し、それ以外は上書き処理となります。

Shallow Merge / シャローマージ

トップレベルのキーのみをマージし、同名キーは全体を上書きする戦略。JavaScriptでは `Object.assign({}, a, b)` と同等の動作です。

Array Concat / 配列連結

配列のマージ戦略の1つ。複数の配列を1つの長い配列に連結し、すべての要素の順序を保持します。主にAPIレスポンスの集約に使用されます。

Array Replace / 配列上書き

配列のマージ戦略の1つ。同名の配列を後入力の内容で全体的に上書きします。主に設定の上書きに使用されます。

Object.assign

JavaScriptの組み込みメソッドで、1つ以上のソースオブジェクトから列挙可能な自身のプロパティをターゲットオブジェクトに浅くコピーします。シャローマージの事実上の標準実装です。

lodash.merge

Lodashライブラリが提供するディープマージ関数で、Node.jsエコシステムで最も広く使われているDeep Mergeの実装。配列は上書きではなく連結されます。

mergedeep (Python)

Pythonエコシステムのディープマージライブラリ。pip install mergedeepでインストール可能。strategyパラメータで配列の連結/上書き動作を制御できます。

jq -s 'add'

jqコマンドで複数のJSON配列を単一の配列に加算する方法。複数のJSONオブジェクトをマージする場合は `reduce .[] as $item ({}; . * $item)` を使用します。

BFF (Backend for Frontend)

マイクロサービスアーキテクチャにおいてフロントエンドとバックエンドサービスの間に位置する集約レイヤー。複数のサービスのJSONレスポンスを統一レスポンスにマージする必要があり、JSONマージの代表的なユースケースです。

JSONマージ戦略4種類の比較

主なJSONマージ実装の対照表

Authoritative References

• MDNObject.assign - MDN Web Docs
• LodashLodash _.merge 公式ドキュメント
• jqjq 公式マニュアル - reduce と add
• IETFJSON 公式仕様 (RFC 8259)