Overview

Creates a deep copy of source, which should be an object or an array.

If no destination is supplied, a copy of the object or array is created.
If a destination is provided, all of its elements (for arrays) or properties (for objects) are deleted and then all elements/properties from the source are copied to it.
If source is not an object or array (inc. null and undefined), source is returned.
If source is identical to destination an exception will be thrown.

Only enumerable properties are taken into account. Non-enumerable properties (both on source and on destination) will be ignored.

@param {} source The source that will be used to make a copy. Can be any type, including primitives, null, and undefined. @param {(Object|Array)=} destination Destination into which the source is copied. If provided, must be of the same type as source. @returns {} The copy or updated destination, if destination was specified.

@example

<div ng-controller="ExampleController">
  <form novalidate class="simple-form">
    <label>Name: <input type="text" ng-model="user.name" /></label><br />
    <label>Age:  <input type="number" ng-model="user.age" /></label><br />
    Gender: <label><input type="radio" ng-model="user.gender" value="male" />male</label>
            <label><input type="radio" ng-model="user.gender" value="female" />female</label><br />
    <button ng-click="reset()">RESET</button>
    <button ng-click="update(user)">SAVE</button>
  </form>
  <pre>form = {{user | json}}</pre>
  <pre>leader = {{leader | json}}</pre>
</div>

// Module: copyExample
angular.
  module('copyExample', []).
  controller('ExampleController', ['$scope', function($scope) {
    $scope.leader = {};

    $scope.reset = function() {
      // Example with 1 argument
      $scope.user = angular.copy($scope.leader);
    };

    $scope.update = function(user) {
      // Example with 2 arguments
      angular.copy(user, $scope.leader);
    };

    $scope.reset();
  }]);

Overview

Usage