[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array/splice [Back]  [Original]

Array.prototype.splice() - JavaScript | MDN

Esta pgina ha sido traducida del ingls por la comunidad. Aprende ms y nete a la comunidad de MDN Web Docs.

View in English Always switch to English

Array.prototype.splice()

Baseline Widely available

This feature is well established and works across many devices and browser versions. Its been available across browsers since julio de 2015.

El mtodo splice() cambia el contenido de un array eliminando elementos existentes y/o agregando nuevos elementos.

In this article

Prubalo

const months = ["Jan", "March", "April", "June"];
months.splice(1, 0, "Feb");
// Inserts at index 1
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "June"]

months.splice(4, 1, "May");
// Replaces 1 element at index 4
console.log(months);
// Expected output: Array ["Jan", "Feb", "March", "April", "May"]

Sintaxis

array.splice(start[, deleteCount[, item1[, item2[, ...]]]])

Parmetros

start

ndice donde se comenzar a cambiar el array (con 0 como origen). Si es mayor que la longitud del array, el punto inicial ser la longitud del array. Si es negativo, empezar esa cantidad de elementos contando desde el final.

deleteCount Opcional

Un entero indicando el nmero de elementos a eliminar del array antiguo.

Si deleteCount se omite, o si su valor es mayor que arr.length - start (esto significa, si es mayor que el nmero de elementos restantes del array, comenzando desde start), entonces todos los elementos desde start hasta el final del array sern eliminados.

Si deleteCount es igual a 0 o negativo, no se eliminar ningn elemento. En este caso, se debe especificar al menos un nuevo elemento (ver ms abajo).

item1, item2, ... Opcional

Los elementos que se agregarn al array, empezando en el ndice start. Si no se especifica ningn elemento, splice() solamente eliminar elementos del array.

Valor devuelto

Un array que contiene los elementos eliminados. Si slo se ha eliminado un elemento, devuelve un array con un solo elemento. Si no se ha eliminado ningn elemento, devuelve un array vaco.

Descripcin

Si especifica un nmero diferente de elementos a agregar que los que se eliminarn, el array tendr un tamao diferente al original una vez finalizada la llamada.

Ejemplos

Eliminar 0 elementos desde el ndice 2 e insertar "drum"

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"];
var removed = myFish.splice(2, 0, "drum");

// myFish is ["angel", "clown", "drum", "mandarin", "sturgeon"]
// removed is [], no elements removed

Eliminar 1 elemento desde el ndice 3

js
var myFish = ["angel", "clown", "drum", "mandarin", "sturgeon"];
var removed = myFish.splice(3, 1);

// removed is ["mandarin"]
// myFish is ["angel", "clown", "drum", "sturgeon"]

Eliminar 1 elemento desde el ndice 2 e insertar "trumpet"

js
var myFish = ["angel", "clown", "drum", "sturgeon"];
var removed = myFish.splice(2, 1, "trumpet");

// myFish is ["angel", "clown", "trumpet", "sturgeon"]
// removed is ["drum"]

Eliminar 2 elementos desde el ndice 0 e insertar "parrot", "anemone" y "blue"

js
var myFish = ["angel", "clown", "trumpet", "sturgeon"];
var removed = myFish.splice(0, 2, "parrot", "anemone", "blue");

// myFish is ["parrot", "anemone", "blue", "trumpet", "sturgeon"]
// removed is ["angel", "clown"]

Eliminar 2 elementos desde el ndice 2

js
var myFish = ["parrot", "anemone", "blue", "trumpet", "sturgeon"];
var removed = myFish.splice(myFish.length - 3, 2);

// myFish is ["parrot", "anemone", "sturgeon"]
// removed is ["blue", "trumpet"]

Eliminar 1 elemento desde el ndice -2

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"];
var removed = myFish.splice(-2, 1);

// myFish is ["angel", "clown", "sturgeon"]
// removed is ["mandarin"]

Eliminar todos los elementos tras el ndice 2 (incl.)

js
var myFish = ["angel", "clown", "mandarin", "sturgeon"];
var removed = myFish.splice(2);

// myFish is ["angel", "clown"]
// removed is ["mandarin", "sturgeon"]

Especificaciones

Specification
ECMAScript 2027 LanguageSpecification
# sec-array.prototype.splice

Compatibilidad con navegadores

Ver tambin

  • push() / pop() aade/elimina elementos desde el final de un array
  • unshift() / shift() aade/elimina elementos desde el principio de un array
  • concat() devuelve un nuevo array compuesto por este array unido a otro/s array/s y/o valor/es

Web Proxy Viewer  |  New URL  |  Original Page