unshift

can.List.prototype.unshift

Add elements to the beginning of a List.

list.unshift(...elements)

unshift adds elements onto the beginning of a List.

the new length of the List

unshift adds elements to the front of the list in bulk in the order specified:

var list = new can.List(['Alice']);

list.unshift('Bob', 'Eve');
list.attr(); // ['Bob', 'Eve', 'Alice']

If you have an array you want to concatenate to the beginning of the List, you can use apply:

var names = ['Bob', 'Eve'],
    list = new can.List(['Alice']);

list.unshift.apply(list, names);
list.attr(); // ['Bob', 'Eve', 'Alice']

unshift causes change, add, and length events to be fired.