JavaScript Array splice() Method
Example
Add items to the array:
var fruits = ["Banana", "Orange", "Apple", "Mango"];
fruits.splice(2, 0, "Lemon", "Kiwi");
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 | Optional. 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: | ECMAScript 1 |
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");
Try it Yourself »
Example
At position 2, remove 2 items:
var fruits = ["Banana", "Orange", "Apple", "Mango", "Kiwi"];
fruits.splice(2, 2);
Try it Yourself »
Related Pages
JavaScript Tutorial: JavaScript Arrays
JavaScript Tutorial: JavaScript Array Methods
❮ JavaScript Array Reference
