Class Ember.Copyable
Implements some standard methods for copying an object. Add this mixin to any object you create that can create a copy of itself. This mixin is added automatically to the built-in array.
You should generally implement the copy()
method to return a copy of the
receiver.
Note that frozenCopy()
will only work if you also implement
Ember.Freezable
.
copy (deep) Object
Defined in packages/ember-runtime/lib/mixins/copyable.js:29
- deep
- Boolean
- if `true`, a deep copy of the object should be made
- returns
- Object
- copy of receiver
Override to return a copy of the receiver. Default implementation raises an exception.
frozenCopy Object
Defined in packages/ember-runtime/lib/mixins/copyable.js:39
- returns
- Object
- copy of receiver or receiver
If the object implements Ember.Freezable
, then this will return a new
copy if the object is not frozen and the receiver if the object is frozen.
Raises an exception if you try to call this method on a object that does not support freezing.
You should use this method whenever you want a copy of a freezable object since a freezable object can simply return itself without actually consuming more memory.