Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.push : ajout à la fin

push ajoute un nombre quelconque de valeurs depuis la longueur courante et renvoie la nouvelle longueur.

Version : ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.push(...items)

array.push(...items) lit length, écrit successivement les éléments à partir de cet indice, fixe la nouvelle length et la renvoie comme nombre. Les arguments sont stockés sans aplatissement ; un appel sans argument renvoie tout de même la longueur courante. La méthode modifie le receveur et est générique pour les objets array-like modifiables.

Un receveur null ou undefined lève TypeError. Si la longueur plus le nombre d’arguments dépassait la longueur sûre maximale 2^53 - 1, l’algorithme lève TypeError. Un vrai Array possède aussi la limite 2^32 - 1. Un indice non inscriptible, une length en lecture seule ou un piège Proxy peut lever une erreur, sans forcément annuler les écritures précédentes. L’exemple montre un tableau, un objet array-like et un tableau non extensible.

Exemples

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);
}

Résultat

3 a,b,c
3 3 yz
TypeError 1

Sources