Latest web development tutorials
 

JavaScript Array splice() Method

< JavaScript Array Reference

Example

Add items to the array:

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2, 0, "Lemon", "Kiwi");

The result of fruits will be:

Banana,Orange,Lemon,Kiwi,Apple,Mango
Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

The splice() method adds/removes items to/from an array, and returns the removed item(s).

Note: This method changes the original array.


Browser Support

The numbers in the table specify the first browser version that fully supports the method.

Method
splice() Yes Yes Yes Yes Yes

Syntax

array.splice(index,howmany,item1,.....,itemX)

Parameter Values

Parameter Description
index Required. An integer that specifies at what position to add/remove items, Use negative values to specify the position from the end of the array
howmany Required. The number of items to be removed. If set to 0, no items will be removed
item1, ..., itemX Optional. The new item(s) to be added to the array

Technical Details

Return Value: A new Array, containing the removed items (if any)
JavaScript Version: 1.2

Examples

More Examples

Example

At position 2, add the new items, and remove 1 item:

var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2, 1, "Lemon", "Kiwi");

The result of fruits will be:

Banana,Orange,Lemon,Kiwi,Mango
Try it Yourself »

Example

At position 2, remove 2 items:

var fruits = ["Banana", "Orange", "Apple", "Mango", "Kiwi"];
fruits.splice(2, 2);

The result of fruits will be:

Banana,Orange,Kiwi
Try it Yourself »

< JavaScript Array Reference