Lodashの.extend()/.assign()と.merge()の違いを徹底解説！浅いコピーと再帰的マージの使い分け

JavaScriptでオブジェクトを扱う際、Lodashの_.assign()（または_.extend()）と_.merge()はどちらもオブジェクトを結合するためのメソッドですが、その動作には重要な違いがあります。この記事では、両者の違いを具体例とともにわかりやすく解説します。

_.assign() / _.extend() の動作：浅いコピー（シャローコピー）

assignやextendは、ソースオブジェクトの各プロパティを取り出し、その値をそのままデスティネーション（コピー先）にコピーします。

ポイントは、プロパティの値がそれ自体オブジェクトだった場合でも、その中身を再帰的にたどらないという点です。つまり、ネストされた子オブジェクトごと丸ごと参照がコピーされます。この方式は「浅いコピー（シャローコピー／シャロークローン）」と呼ばれます。

結果として、デスティネーションに同名のプロパティがある場合、その値はソース側の値で完全に上書きされます。

_.merge() の動作：再帰的なディープマージ

一方、mergeは、ソースオブジェクトの各プロパティについて、「その値がオブジェクト自身かどうか」をチェックします。

もしオブジェクトであれば、再帰的に処理を進め、子オブジェクトのプロパティ同士をソースからデスティネーションへ対応付けて統合します。これにより、ネストされた構造を持つオブジェクトでも、階層を保ったまま内容をマージできます。この方式は「ディープマージ（深い結合）」と呼ばれます。

コード例

実際のコードで違いを見てみましょう。

let _ = require('lodash');
let destination = {
    a: {
        b: 1,
        c: 2
    },
};
let source = {
    a: {
        d: 2,
        c: 3
    },
};
console.log(_.merge(destination, source));
console.log(_.extend(destination, source));

出力結果

このコードを実行すると、以下の出力が得られます。

{ a: { b: 1, c: 3, d: 2 } }
{ a: { d: 2, c: 3 } }

結果のポイント

mergeでは、aの中のプロパティが再帰的に統合され、b・c・dすべてが保持されています（cはソース側の値3で上書き）。一方、extendでは、aの値がソース側のオブジェクトで丸ごと置き換えられているため、デスティネーション側にあったb: 1は失われています。

使い分けの目安

• _.assign() / _.extend()：フラットなオブジェクトの結合や、単純にプロパティを上書きしたい場合に最適。処理も高速です。
• _.merge()：設定オブジェクトのようなネストされたデータ構造を統合したい場合に最適。既存の階層構造を壊さずにマージできます。

ネストされたオブジェクトを扱う場合は、意図しないデータ損失を避けるために、mergeを使うのが安全です。