Microsoft® JScript™ slice Method (Array)

Language Reference  Version 3

See Also                  Applies To

Description

Returns a section of an array.

Syntax

arrayObj.slice(start, [end])

The slice method syntax has these parts:

Part	Description
arrayObj	Required. An Array object.
start	Required. The zero-based index of the beginning of the specified portion of arrayObj.
end	Optional. The zero-based index of the end of the specified portion of arrayObj.

Remarks

The slice method returns an Array object containing the specified portion of arrayObj. It also works on strings: slice Method (String)

The slice method copies up to, but not including, the element indicated by end.

let array = [1, 2, 3, "hello world", 4.12, true];
array.slice(0, 3); // returns [1, 2, 3] but does NOT include array[3] "hello world"

If negative, end indicates an offset from the end of arrayObj. In addition, it is not zero-based. If omitted, extraction continues to the end of arrayObj.

In the example that follows, all but the last element of myArray is copied into newArray:

newArray.slice(0, -1))

If an object reference is copied from arrayObj to the result, the object reference in the result still points to the same object. Changes to that object are reflected in both arrays.

© 1997 by Microsoft Corporation. All rights reserved.