splice array method changes an existing array by removing, adding and/or replacing specified elements from it. The method mutates the array and returns an array of all elements removed from the array. An empty array is returned if no elements are removed.
[1, 2, 3, 4, 5].splice(1, 3) // [2, 3, 4]
array.splice(startIndex, deleteCount[, item1, item2, ...])
This is the index at which the method begins making changes to the array. If the value provided is less than
0 or negative, it will start at that index from the end of the array rather than the beginning. If the value is greater than the length of the array, the value will be set to the length of the array.
This is the number of items to remove from the array. If the value specified is greater than the difference of array
length and the
startIndex, every element from the
startIndex to the end of the array will be deleted. If the value is
0 or less, no elements are removed from the array.
This is the value to be added to the array starting from the
splice() will remove elements from the array if no
items are provided.
Returns an array
This method will return an array of all elements removed from the array. If no elements are removed from the array, an empty array is returned.
const numbers = [1, 2, 4, 5]; numbers.splice(2, 0, 3); // numbers: Array [1, 2, 3, 4, 5] const oddNumbers = [1, 3, 5, 7, 11]; oddNumbers.splice(4, 1, 9); // numbers: Array [1, 3, 5, 7, 9] oddNumbers.splice(3, 1); // numbers: Array [1, 3, 5, 9]
Splice mutates the original array and leaves only the remaining array items after the deletions or replacements.
Common Uses and Snippets
Remove an element at a particular index in an array
.splice() method is commonly used to remove a particular element in an array.
Adding new elements starting from a position
splice() method is also used to add new elements in a given position in an array.