Course contentsShow
← JavaScript
Lesson 878 of 2,72320. Array Iteration and TransformationFree lesson

Understanding Array.prototype.find()

Learn how find() returns the first element that satisfies a condition, or undefined if none match.

Understanding Array.prototype.find()

What you'll learn: How to use find() to locate the first element in an array that meets your condition.

What Is find()?

The find() method searches through an array from left to right and returns the first element that satisfies a test condition. If no element passes the test, it returns undefined.

Think of it like scanning a parking lot for the first available space—you stop as soon as you find one that works.

How It Works

find() takes a callback function (a predicate) that tests each element. The callback receives three parameters: the current element, its index, and the whole array. You typically only need the first parameter.

const numbers = [5, 12, 8, 130, 44];

const firstLarge = numbers.find(num => num > 10);
console.log(firstLarge); // 12 (first element greater than 10)

When Nothing Matches

If no element satisfies the condition, find() returns undefined:

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

const result = numbers.find(num => num > 10);
console.log(result); // undefined

Practical Example

const users = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
  { id: 3, name: 'Charlie' }
];

const user = users.find(u => u.id === 2);
console.log(user); // { id: 2, name: 'Bob' }

const missing = users.find(u => u.id === 99);
console.log(missing); // undefined

Key Differences

Unlike filter(), which returns all matching elements in a new array, find() stops at the first match and returns just that single element (or undefined).

Key Takeaway: Use find() when you need the first element matching a condition—it returns that element or undefined if nothing matches.