slice Method (Array) (JavaScript)

Returns a section of an array.

arrayObj.slice(start, [end]) 

arrayObj

Required. An Array object.

start

Required. The beginning of the specified portion of arrayObj.

end

Optional. 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 show how to use 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.

var origArray = [3, 5, 7, 9];
var newArray = origArray. slice(0, -1);
document.write(origArray);
document.write("<br/>");
newArray = origArray. slice(-2);
document.write(newArray);

// Output:
// 3,5,7,9
// 7,9

Supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards, Internet Explorer 11 standards. Also supported in Store apps (Windows 8 and Windows Phone 8.1). See Version Information.

Show:
© 2014 Microsoft