Array.prototype.push()

El mètode push() afegeix un o més elements al final d'un array i retorna el nou tamany de l'array.

Sintaxi

arr.push(element1, ..., elementN)

Paràmetres

elementN

Els elements que seran afegits al final de l'array.

Valor retornat

El nou valor de la propietat length de l'objecte del qual s'ha executat el mètode.

Descripció

El mètode push afegeix valors a un array.

push és genèric de manera intencionada. Es pot utilitzar aquest mètode amb call() i apply() en objectes semblants a arrays. El mètode push depèn de la propietat length per a determinar on insertar els nous valors. Si la propietat length no es pot convertir en un nombre, la posició utilitzada serà la 0. Això inclou la posibilitat que no existeixi la propietat length, en aquest case es crearà automàticament la propietat length.

Els únics objectes semblants a arrays que inclou el nucli de JavaScript són els strings, tot i que no admeten la aplicació d'aquest mètode ja que els strings són immutables.

Exemples

Afegir elements a un array

El codi següent crea un array anomenat esports que conté dos elements, llavors l'hi afegeix dos elements més. La variable total acaba revent el valor del nou tamany d e l'array.

var esports = ['fubtol', 'basket'];
var total = sports.push('badminton', 'natació');

console.log(sports); // ['fubtol', 'basket', 'badminton', 'natació']
console.log(total);  // 4

Unir dos arrays

Aquest exemple utilitza apply() per a afegir tots els elements d'un segon array.

var verdures = ['ceba', 'patata'];
var mesVerdures = ['pastanaga', 'rabe'];

// Uneix el segon array al primer
// Equivalent a verdures.push('pastanaga', 'rabe');
Array.prototype.push.apply(verdures , mesVerdures);

console.log(verdures); // ['ceba', 'patata', 'pastanaga', 'rabe']

Especificacions

Compatibilitat amb navegadors

Vegeu també

• Array.prototype.pop()
• Array.prototype.shift()
• Array.prototype.unshift()
• Array.prototype.concat()