Class Ember.Copyable

Module: ember
Since: vEmber 0.9

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.

Show:

Module: ember
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.

Module: ember
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.