Course contentsShow
← JavaScript
Lesson 472 of 2,72312. Higher-Order FunctionsFree lesson

The Find Method: Locating Elements

Learn how Array.find() returns the first element that passes a test function, or undefined.

The Find Method: Locating Elements

You'll learn how to use Array.find() to locate the first element in an array that matches your criteria.

What Find Does

Think of find() like searching through a stack of papers for the first one that meets your needs—maybe the first invoice over $100, or the first form signed by a specific person. Once you find it, you stop looking and take that paper. If you search the entire stack and find nothing, you come up empty-handed.

Array.find() takes a test function (predicate) and returns the first element that makes that function return true. If no element passes the test, it returns undefined.

The Syntax

const result = array.find(element => testCondition);

The callback receives the same parameters you've seen with map and filter: the current element, index, and the full array.

Examples

const numbers = [5, 12, 8, 130, 44];
const firstLarge = numbers.find(num => num > 10);
console.log(firstLarge); // 12 (stops at first match)

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

When to Use Find

Use find() when you need one specific item from an array based on a condition. Unlike filter() which returns all matches in a new array, find() returns just the first match as a single element (or undefined).

Key Takeaway: Array.find() returns the first element that passes your test function, or undefined if nothing matches—perfect for locating a single item in an array.