Push the object onto the end of the array if it is not already present in the array.

var cities = ["Chicago", "Berlin"];
cities.addObject("Lima");    // ["Chicago", "Berlin", "Lima"]
cities.addObject("Berlin");  // ["Chicago", "Berlin", "Lima"]

Remove all elements from the array. This is useful if you want to reuse an existing array without having to recreate it.

var colors = ["red", "green", "blue"];
color.length();   //  3
colors.clear();   //  []
colors.length();  //  0

This will use the primitive replace() method to insert an object at the specified index.

var colors = ["red", "green", "blue"];
colors.insertAt(2, "yellow");  // ["red", "green", "yellow", "blue"]
colors.insertAt(5, "orange");  // Error: Index out of range

Pop object from array or nil if none are left. Works just like pop() but it is KVO-compliant.

var colors = ["red", "green", "blue"];
colors.popObject();   // "blue"
console.log(colors);  // ["red", "green"]

Push the object onto the end of the array. Works just like push() but it is KVO-compliant.

var colors = ["red", "green"];
colors.pushObject("black");     // ["red", "green", "black"]
colors.pushObject(["yellow"]);  // ["red", "green", ["yellow"]]

Add the objects in the passed numerable to the end of the array. Defers notifying observers of the change until all objects are added.

var colors = ["red"];
colors.pushObjects(["yellow", "orange"]);  // ["red", "yellow", "orange"]

Remove an object at the specified index using the replace() primitive method. You can pass either a single index, or a start and a length.

If you pass a start and length that is beyond the length this method will throw an OUT_OF_RANGE_EXCEPTION.

var colors = ["red", "green", "blue", "yellow", "orange"];
colors.removeAt(0);     // ["green", "blue", "yellow", "orange"]
colors.removeAt(2, 2);  // ["green", "blue"]
colors.removeAt(4, 2);  // Error: Index out of range

Remove all occurances of an object in the array.

var cities = ["Chicago", "Berlin", "Lima", "Chicago"];
cities.removeObject("Chicago");  // ["Berlin", "Lima"]
cities.removeObject("Lima");     // ["Berlin"]
cities.removeObject("Tokyo")     // ["Berlin"]

Required. You must implement this method to apply this mixin.

This is one of the primitives you must implement to support Ember.Array. You should replace amt objects started at idx with the objects in the passed array. You should also call this.enumerableContentDidChange()

Reverse objects in the array. Works just like reverse() but it is KVO-compliant.

Replace all the the receiver's content with content of the argument. If argument is an empty array receiver will be cleared.

var colors = ["red", "green", "blue"];
colors.setObjects(["black", "white"]);  // ["black", "white"]
colors.setObjects([]);                  // []

Shift an object from start of array or nil if none are left. Works just like shift() but it is KVO-compliant.

var colors = ["red", "green", "blue"];
colors.shiftObject();  // "red"
console.log(colors);   // ["green", "blue"]

Unshift an object to start of array. Works just like unshift() but it is KVO-compliant.

var colors = ["red"];
colors.unshiftObject("yellow");    // ["yellow", "red"]
colors.unshiftObject(["black"]);   // [["black"], "yellow", "red"]

Adds the named objects to the beginning of the array. Defers notifying observers until all objects have been added.

var colors = ["red"];
colors.unshiftObjects(["black", "white"]);   // ["black", "white", "red"]
colors.unshiftObjects("yellow"); // Type Error: 'undefined' is not a function