feat(extend): optionally deep-extend when last parameter is true

Author: prettycode

src/Angular.js

@@ -333,22 +333,32 @@ function setHashKey(obj, h) {
  * Extends the destination object `dst` by copying own enumerable properties from the `src` object(s)
  * to `dst`. You can specify multiple `src` objects. If you want to preserve original objects, you can do so
  * by passing an empty object as the target: `var object = angular.extend({}, object1, object2)`.
- * Note: Keep in mind that `angular.extend` does not support recursive merge (deep copy).
+ * Note: Pass `true` in as the last argument to perform a recursive merge (deep copy).
  *
  * @param {Object} dst Destination object.
  * @param {...Object} src Source object(s).
  * @returns {Object} Reference to `dst`.
  */
 function extend(dst) {
   var h = dst.$$hashKey;
+  var argsLength = arguments.length;
+  var isDeep = (argsLength >= 3) && (arguments[argsLength - 1] === true);
 
-  for (var i = 1, ii = arguments.length; i < ii; i++) {
+  if (isDeep) --argsLength;
+
+  for (var i = 1; i < argsLength; i++) {
     var obj = arguments[i];
     if (obj) {
       var keys = Object.keys(obj);
       for (var j = 0, jj = keys.length; j < jj; j++) {
         var key = keys[j];
-        dst[key] = obj[key];
+        var src = obj[key];
+        
+        if (isDeep && isObject(dst[key])) { 
+          src = extend(dst[key], src, true);
+        }
+        
+        dst[key] = src;
       }
     }
   }

test/AngularSpec.js

@@ -223,6 +223,21 @@ describe('angular', function() {
       // make sure we retain the old key
       expect(hashKey(dst)).toEqual(h);
     });
+
+    it('should perform deep extend when last argument is true', function() {
+      var src = { foo: { bar: 'foobar', age: 10, nothing: null, undef: void 0 }},
+          dst = { foo: { bazz: 'foobazz' }};
+      extend(dst, src, true);
+      expect(dst).toEqual({
+        foo: {
+          bar: 'foobar',
+          bazz: 'foobazz',
+          age: 10,
+          nothing: null,
+          undef: void 0
+        }
+      });
+    });
   });
 
   describe('shallow copy', function() {