JavaScript Array splice() Method
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() | 1.0 | 5.5 | 1.0 | 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 |
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
