CKTIS / JavaScript
Array.prototype.splice: eliminar, sustituir e insertar
splice muta un array en la posición elegida, desplaza su cola y devuelve un array nuevo con los elementos eliminados.
Versión: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxis
array.splice(start, deleteCount?, ...items)array.splice(start, deleteCount?, ...items) modifica array in situ y devuelve un array nuevo con los elementos eliminados. start se convierte en entero: un valor negativo cuenta desde el final y una posición posterior a la longitud significa el final. Si se aporta start pero se omite deleteCount, elimina toda la cola; pasar undefined explícitamente significa cero. Los demás valores se limitan entre cero y los elementos restantes. items se insertan antes de la cola desplazada.
La longitud del resultado coincide con las posiciones eliminadas y los huecos correspondientes siguen siendo huecos. El receptor puede crecer, menguar o conservar su longitud; splice() sin argumentos no elimina nada. En subclases de Array, la creación del resultado respeta Symbol.species.
El método es genérico para objetos array-like mutables: lee length, copia o elimina propiedades indexadas y escribe la nueva longitud. Puede lanzar TypeError si no se permite escribir, eliminar o cambiar length, o si la longitud nueva superaría 2^53 - 1; se propagan errores de conversión, accesores, traps de proxy y constructor species.
Ejemplos
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(","));Resultado
test build,lint,test,deploy test,deploy build,lint 0 build,docs,lint 2 false true b c