Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes