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

CKTIS / JavaScript

Array.prototype.unshift : ajouter au début

unshift décale les indices existants vers la droite, insère ses arguments au début et renvoie la nouvelle longueur du receveur.

Version : ECMAScript 1 onward; example target: Node.js 24.22.2

Syntaxe

array.unshift(...items)

array.unshift(...items) modifie array : il décale les propriétés indexées vers les indices supérieurs du nombre d’arguments, écrit items à partir de zéro et met length à jour. Il renvoie la nouvelle longueur ; les arguments gardent leur ordre, donc unshift("a", "b") place a avant b. Sans argument, la longueur reste identique.

Les trous sont conservés pendant le décalage : une propriété source absente entraîne la suppression de la propriété destination correspondante. La méthode est générique pour les objets array-like modifiables et ne crée aucun tableau résultat.

Si la nouvelle longueur dépassait 2^53 - 1, elle lève TypeError ; les Arrays ordinaires ont une limite supplémentaire. Des indices ou length non inscriptibles, des propriétés non supprimables et les erreurs de getters, setters ou traps de proxy peuvent interrompre l’opération après des changements partiels. L’API remonte à ECMAScript 1.

Exemples

const queue = ["test", "deploy"];
const length = queue.unshift("lint", "build");
console.log(length, queue.join(","));

const sparse = [, "b"];
const sparseLength = sparse.unshift("a");
console.log(sparseLength, 0 in sparse, 1 in sparse, 2 in sparse, sparse[0], sparse[2]);

const arrayLike = { 1: "second", length: 2 };
const result = Array.prototype.unshift.call(arrayLike, "first");
console.log(result, arrayLike.length, arrayLike[0], 1 in arrayLike, arrayLike[2]);

Résultat

4 lint,build,test,deploy
3 true false true a b
3 3 first false second

Sources