CKTIS / JavaScript
Array.prototype.toSpliced : copie modifiée sans mutation
toSpliced renvoie un nouveau tableau après suppression et insertion de positions choisies sans modifier le receveur.
Version : ECMAScript 2023; example target: Node.js 24.22.2
Syntaxe
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) est la variante par copie de splice() : elle crée un nouvel Array ordinaire, omet une plage, insère items et laisse array inchangé. Un start négatif compte depuis la fin ; au-delà de la longueur, il désigne la fin. Avec start, un skipCount omis supprime la fin, undefined explicite signifie zéro et les autres valeurs sont bornées à la plage disponible.
Le résultat est la copie modifiée entière, pas un tableau des éléments supprimés. La copie est superficielle, toujours dense et ignore Symbol.species : les trous deviennent des propriétés propres valant undefined. Sans argument, on obtient une copie dense.
La méthode, normalisée dans ECMAScript 2023, est générique pour les valeurs array-like. Un receveur null ou undefined lève TypeError ; une longueur calculée excessive produit TypeError ou RangeError, et les erreurs de conversion, getters et traps de proxy se propagent.
Exemples
const source = ["build", "test", "deploy"];
const changed = source.toSpliced(1, 1, "lint", "test");
console.log(changed.join(","));
console.log(source.join(","));
console.log(source.toSpliced(-1).join(","));
console.log(source.toSpliced(1, undefined, "docs").join(","));
const dense = [1, , 3].toSpliced(1, 0, 2);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, 3 in dense);
console.log(dense[0], dense[1], String(dense[2]), dense[3]);Résultat
build,lint,test,deploy build,test,deploy build,test build,docs,test,deploy 4 true true true true 1 2 undefined 3