Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

indexOf Method (Array) (JavaScript)

Returns the index of the first occurrence of a value in an array.

array1.indexOf(searchElement[, fromIndex])

Parameter

Definition

array1

Required. An array object.

searchElement

Required. The value to locate in array1.

fromIndex

Optional. The array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.

The index of the first occurrence of searchElement in the array, or -1 if searchElement is not found.

The indexOf method searches an array for a specified value. The method returns the index of the first occurrence, or -1 if the specified value is not found.

The search occurs in ascending index order.

The array elements are compared to the searchElement value by strict equality, similar to the === operator. For more information, see Comparison Operators (JavaScript).

The optional fromIndex argument specifies the array index at which to begin the search. If fromIndex is greater than or equal to the array length, -1 is returned. If fromIndex is negative, the search starts at the array length plus fromIndex.

The following examples illustrate the use of the indexOf method.

// Create an array. (The elements start at index 0.)
var ar = ["ab", "cd", "ef", "ab", "cd"];

// Determine the first location of "cd".
// Output: 1
alert(ar.indexOf("cd"));

// Find "cd" starting at index 2.
// Output: 4
alert(ar.indexOf("cd", 2));

// Find "gh" (which is not found).
// Output: -1
alert(ar.indexOf("gh"));

// Find "ab" with a fromIndex argument of -2.
// The search starts at index 3, which is the array length plus -2.
// Output: 3
alert(ar.indexOf("ab", -2))

Supported in the Internet Explorer 9 standards document mode. See Version Information.

Not supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft. All rights reserved.