CKTIS / JavaScript
Array.prototype.toSpliced: copia modificada sin mutación
toSpliced devuelve un array nuevo tras eliminar e insertar posiciones seleccionadas sin modificar el receptor.
Versión: ECMAScript 2023; example target: Node.js 24.22.2
Sintaxis
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) es la variante por copia de splice(): crea un Array ordinario nuevo, omite un tramo, inserta items y deja array intacto. Un start negativo cuenta desde el final; una posición posterior a la longitud significa el final. Con start, omitir skipCount elimina la cola, undefined explícito significa cero y los demás valores se limitan al rango disponible.
El resultado es la copia modificada completa, no un array de elementos eliminados. Es superficial, siempre densa e ignora Symbol.species: los huecos del receptor pasan a ser propiedades propias con valor undefined. Sin argumentos devuelve una copia densa.
El método se estandarizó en ECMAScript 2023 y es genérico para valores array-like. Un receptor null o undefined lanza TypeError; una longitud calculada excesiva produce TypeError o RangeError, y se propagan fallos de conversión, getters y traps de proxy.
Ejemplos
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]);Resultado
build,lint,test,deploy build,test,deploy build,test build,docs,test,deploy 4 true true true true 1 2 undefined 3