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