Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes