JavaScript Array indexOf() Method

What You’ll Learn

The indexOf() method returns the first index where a value appears, or -1 if it is missing. Optional fromIndex controls where the search starts. This tutorial covers syntax, five examples, strict equality, and how indexOf() compares to includes() and lastIndexOf().

Introduction

When you need the position of a value—not just whether it exists—indexOf() is the classic array search method. It scans from the start (or from fromIndex) and stops at the first match.

For a simple yes/no check, modern code often prefers includes(). Use indexOf() when the index itself matters: splicing, inserting nearby, or deduplicating.

Understanding the indexOf() Method

array.indexOf(searchElement, fromIndex?) compares each element with strict equality (===). The return value is a zero-based index or -1.

Duplicate values are common. indexOf always returns the first occurrence. To find the last match, use lastIndexOf().

📝 Syntax

General form of Array.prototype.indexOf:

array.indexOf(searchElement, fromIndex)

Parameters

• searchElement — value to locate.
• fromIndex — optional; index to start searching (default 0).

Return value

• First matching index (0 or greater).
• -1 if no match.
• Original array unchanged.

Common patterns

• arr.indexOf("blue") — find first index.
• arr.indexOf("blue", 2) — search from index 2.
• arr.indexOf(x) !== -1 — membership test (prefer includes).
• arr.filter((v, i, a) => a.indexOf(v) === i) — dedupe pattern.

Examples Gallery

Open DevTools Console (F12) or use Try-it labs. Example N maps to ?tryit=N.

const colors = ["red", "blue", "green", "yellow", "blue"];

console.log(colors.indexOf("green"));
// 2

2

const colors = ["red", "blue", "green", "yellow", "blue"];

console.log(colors.indexOf("blue"));
// 1 (first "blue")

console.log(colors.indexOf("blue", 2));
// 4 (second "blue")

1
4

const colors = ["red", "blue", "green"];

const index = colors.indexOf("purple");

console.log(index);
// -1

if (index !== -1) {
  console.log("Found at", index);
} else {
  console.log("Not in array");
}
// Not in array

-1
Not in array

const numbers = [1, 2, 3, 4, 5];

console.log(numbers.indexOf(3));
// 2

console.log(numbers.indexOf("3"));
// -1

2
-1

const colors = ["red", "blue", "green", "yellow", "blue"];

const unique = colors.filter(
  (value, index, array) => array.indexOf(value) === index
);

console.log(unique);
// ["red", "blue", "green", "yellow"]

["red", "blue", "green", "yellow"]

🚀 Common Use Cases

• Find position — locate an item before splice or insert.
• Membership via index — indexOf(x) !== -1 (or use includes).
• Deduplication — filter where indexOf(v) === i.
• Skip processed items — pass fromIndex to find next duplicate.
• Simple lookups — tags, enums, or menu item positions.
• Legacy compatibility — widely supported ES5 search API.

📝 Notes

• Returns first match only—use lastIndexOf for last.
• Not found → -1 (index 0 is valid).
• Strict ===; does not find NaN.
• Objects match by reference, not deep equality.
• For boolean checks, prefer includes() in modern code.
• ES5—excellent support including IE9+.

💡 Best Practices