CKTIS / JavaScript
Array.prototype.push: adição no fim
push acrescenta qualquer número de valores desde o comprimento atual e devolve o novo comprimento do recetor.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
array.push(...items)array.push(...items) lê length, escreve os elementos sucessivos a partir desse índice, define a nova length e devolve-a como número. Os argumentos são guardados sem achatamento; uma chamada sem argumentos continua a devolver o comprimento atual. O método altera o recetor e é genérico para objetos array-like modificáveis.
Um recetor null ou undefined lança TypeError. Se o comprimento mais o número de argumentos excedesse o comprimento seguro máximo 2^53 - 1, o algoritmo lança TypeError. Um Array real tem ainda o limite 2^32 - 1. Um índice não gravável, uma length só de leitura ou uma armadilha Proxy pode lançar um erro, e escritas anteriores não têm de ser revertidas. O exemplo mostra um array, um objeto array-like e um array não extensível.
Exemplos
const values = ["a"];
console.log(values.push("b", "c"), values.join(","));
const record = { 0: "x", length: 1 };
console.log(Array.prototype.push.call(record, "y", "z"), record.length, record[1] + record[2]);
const fixed = Object.preventExtensions(["x"]);
try { fixed.push("y"); } catch (error) {
console.log(error.name, fixed.length);
}Resultado
3 a,b,c 3 3 yz TypeError 1