API Docs for: 1.0 pre
Show:

Ember.Copyable Class

Defined in: ../packages_es6/ember-runtime/lib/mixins/copyable.js:16
Module: ember-runtime
Parent Module: ember

Available since Ember 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.

Item Index

Methods

Methods

copy

(
  • deep
)
Object

Defined in ../packages_es6/ember-runtime/lib/mixins/copyable.js:33

Override to return a copy of the receiver. Default implementation raises an exception.

Parameters:

  • deep Boolean

    if true, a deep copy of the object should be made

Returns:

Object:

copy of receiver

frozenCopy

() Object

Defined in ../packages_es6/ember-runtime/lib/mixins/copyable.js:43

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.

Returns:

Object:

copy of receiver or receiver