Array.prototype.unshift()

Metoda unshift() adaugă unul sau mai multe elemente la începutul unui obiect de tip tablou și returnează noua lungime a tabloului.

Sintaxa

arr.unshift([element1[, ...[, elementN]]])

Parametri

elementN

Elementele de adăugat la începutul tabloului.

Returnează

Noua valoare a proprietății length a obiectului care a apelat metoda.

Descriere

The unshift method inserts the given values to the beginning of an array-like object.

unshift is intentionally generic; this method can be called or applied to objects resembling arrays. Objects which do not contain a length property reflecting the last in a series of consecutive, zero-based numerical properties may not behave in any meaningful manner.

Exemple

var arr = [1, 2];

arr.unshift(0); // result of call is 3, the new array length
// arr is [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr is [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr is [[-3], -2, -1, 0, 1, 2]

Specificații

Browser compatibility

See also

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.shift()