slice Method (Array) (JavaScript)

arrayObj

Required. An Array object.

start

Required. The index to the beginning of the specified portion of arrayObj.

end

Optional. The index to the end of the specified portion of arrayObj.

The slice method returns an Array object containing the specified portion of arrayObj.

The slice method copies up to, but not including, the element indicated by end. If start is negative, it is treated as length + start where length is the length of the array. If end is negative, it is treated as length + end where length is the length of the array. If end is omitted, extraction continues to the end of arrayObj. If end occurs before start, no elements are copied to the new array.

The following examples illustrate the use of the slice method. In the first example, all but the last element of myArray is copied into newArray. In the second example, only the last two elements of myArray are copied into newArray.

newArray = myArray.slice(0, -1)
newArray = myArray.slice(-2)

Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards. See Version Information.

Applies To: Array Object (JavaScript)

Reference