Array.prototype.toSpliced() - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

Español

Remember language Learn more

Array.prototype.toSpliced()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2023.

El método toSpliced() pertenece a las instancias de Array y es la versión copying del método splice(). Devuelve un nuevo array con elementos eliminados y/o reemplazados en un índice dado.

Sintaxis

js
toSpliced(start)
toSpliced(start, skipCount)
toSpliced(start, skipCount, item1)
toSpliced(start, skipCount, item1, item2)
toSpliced(start, skipCount, item1, item2, /* …, */ itemN)

Parámetros

start

Índice basado en cero a partir del cual se comienzan a modificar los elementos del array, convertido en un entero.

Un índice negativo cuenta hacia atrás desde el final del array — si -array.length <= start < 0, se usa start + array.length.
Si start < -array.length o start se omite, se usa 0.
Si start >= array.length, no se eliminará ningún elemento, pero el método se comportará como una función de adición, agregando tantos elementos como se hayan proporcionado.

skipCount Opcional

Un entero que indica el número de elementos que se deben eliminar (o saltear) del array a partir de start.

Si skipCount se omite, o si su valor es mayor o igual a la cantidad de elementos después de la posición indicada por start, entonces se eliminarán todos los elementos desde start hasta el final del array. Sin embargo, si deseas pasar cualquier parámetro itemN, deberías pasar Infinity como skipCount para eliminar todos los elementos después de start, ya que un valor explícito undefined se convierte en 0.

Si skipCount es 0 o negativo, no se eliminarán elementos. En ese caso, debes especificar al menos un nuevo elemento (ver abajo).

item1, …, itemN Opcional

Los elementos que se añadirán al array, comenzando desde start.

Si no se especifica ningún elemento, toSpliced() solo eliminará elementos del array.

Valor de retorno

Un nuevo array que consta de todos los elementos anteriores a start, seguidos de item1, item2, …, itemN, y de todos los elementos posteriores a start + skipCount.

Descripción

El método toSpliced(), al igual que splice(), realiza múltiples operaciones a la vez: elimina el número especificado de elementos del array a partir del índice dado, y a continuación, inserta los elementos especificados en ese mismo índice. Sin embargo, devuelve un nuevo array en lugar de modificar el original, por lo que los elementos eliminados no se devuelven, sino que permanecen accesibles en el array original.

El método toSpliced() nunca produce un array disperso. Si el array de origen es disperso, los espacios vacíos se reemplazan por undefined en el nuevo array.

El método toSpliced() es genérico. Solo espera que el valor de this tenga una propiedad length y propiedades indexadas por enteros.

Ejemplos

Eliminando, agregando y reemplazando elementos

toSpliced() permite eliminar, agregar y reemplazar elementos de un array, y crear uno nuevo de forma más eficiente que usando slice() y concat().

js
const months = ["Jan", "Mar", "Apr", "May"];

// Insertando un elemento en el índice 1
const months2 = months.toSpliced(1, 0, "Feb");
console.log(months2); // ["Jan", "Feb", "Mar", "Apr", "May"]

// Eliminando dos elementos empezando desde el índice 2
const months3 = months2.toSpliced(2, 2);
console.log(months3); // ["Jan", "Feb", "May"]

// Reemplazando un elemento en el índice 1 con dos nuevos elementos
const months4 = months3.toSpliced(1, 1, "Feb", "Mar");
console.log(months4); // ["Jan", "Feb", "Mar", "May"]

// El array original no fue modificado
console.log(months); // ["Jan", "Mar", "Apr", "May"]

Uso de toSpliced() en arrays dispersos

El método toSpliced() siempre crea un array denso, reemplazando los huecos por undefined.

js
const arr = [1, , 3, 4, , 6];
console.log(arr.toSpliced(1, 2)); // [1, 4, undefined, 6]

Llamar toSpliced() en objetos que no son arrays

El método toSpliced() lee la propiedad length de this. A continuación, lee las propiedades con claves enteras necesarias y las escribe en el nuevo array.

js
const arrayLike = {
  length: 3,
  unrelated: "foo",
  0: 5,
  2: 4,
};
console.log(Array.prototype.toSpliced.call(arrayLike, 0, 1, 2, 3));
// [2, 3, undefined, 4]

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 14 ene 2026 by MDN contributors.

View this page on GitHub • Report a problem with this content