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

CKTIS / JavaScript

Array.prototype.splice : supprimer, remplacer et insérer

splice modifie un tableau à une position choisie, décale sa fin et renvoie un nouveau tableau des éléments supprimés.

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

Syntaxe

array.splice(start, deleteCount?, ...items)

array.splice(start, deleteCount?, ...items) modifie array sur place et renvoie un nouveau tableau contenant les éléments supprimés. start est converti en entier : une valeur négative compte depuis la fin, une position au-delà de la longueur désigne la fin. Si start est fourni mais deleteCount omis, toute la fin est supprimée ; passer explicitement undefined signifie zéro. Les autres valeurs sont bornées entre zéro et le nombre restant. items sont insérés avant la partie décalée.

La longueur du résultat égale le nombre de positions supprimées et les trous correspondants restent des trous. Le receveur peut grandir, rétrécir ou garder sa longueur ; splice() sans argument ne supprime rien. Pour une sous-classe d’Array, la création du résultat respecte Symbol.species.

La méthode est générique pour les objets array-like modifiables : elle lit length, copie ou supprime des propriétés indexées et écrit la nouvelle longueur. Elle peut lever TypeError si une écriture, suppression ou length est interdite, ou si la nouvelle longueur dépasserait 2^53 - 1 ; les erreurs de conversion, accesseurs, traps de proxy et constructeur species se propagent.

Exemples

const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));

const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));

const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));

const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));

Résultat

test
build,lint,test,deploy
test,deploy
build,lint
0 build,docs,lint
2 false true b c

Sources