docs(angular.copy): clarify corner cases

The behaviour when null or undefined was passed was not clear.
The exception thrown when source == destination was not documented.

Closes #3946
This commit is contained in:
jakub-bochenski 2013-09-10 13:37:51 +02:00 committed by Pete Bacon Darwin
parent 8a7240ddfd
commit f102fb75b6

View file

@ -578,7 +578,8 @@ function isLeafNode (node) {
* * If no destination is supplied, a copy of the object or array is created.
* * If a destination is provided, all of its elements (for array) 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, `source` is returned.
* * 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.
*
* Note: this function is used to augment the Object type in Angular expressions. See
* {@link ng.$filter} for more information about Angular arrays.