Skip to content

Commit

Permalink
docs(angular.copy): list object types / features that are not supported
Browse files Browse the repository at this point in the history
  • Loading branch information
Narretz committed Jan 14, 2019
1 parent dcdcb33 commit 81c4cd1
Showing 1 changed file with 13 additions and 1 deletion.
14 changes: 13 additions & 1 deletion src/Angular.js
Original file line number Diff line number Diff line change
Expand Up @@ -783,7 +783,9 @@ function arrayRemove(array, value) {
* @kind function
*
* @description
* Creates a deep copy of `source`, which should be an object or an array.
* Creates a deep copy of `source`, which should be an object or an array. This functions is used
* internally, mostly in the change-detection code. It is not intended as an all-purpose copy
* functions, and has several limitations (see below).
*
* * 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)
Expand All @@ -803,6 +805,16 @@ function arrayRemove(array, value) {
* developers responsibility to make sure they are compatible.
* </div>
*
* @knownIssue
* This is a list of (known) object types / features that are not handled correctly by this function:
* - [`ImageData`](https://developer.mozilla.org/docs/Web/API/File)
* - [`Map`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)
* - [`ImageData`](https://developer.mozilla.org/docs/Web/API/ImageData)
* - [`MediaStream`](https://developer.mozilla.org/docs/Web/API/MediaStream)
* - [`WeakMap`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/WeakMap)
* - ['getter'](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/get)/
* [`setter`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Functions/set)`
*
* @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,
Expand Down

0 comments on commit 81c4cd1

Please sign in to comment.