Skip to main content

find

_.find(predicate, collection) # Ⓢ [Ⓣ][1] Ⓝ

Iterates over elements of collection, returning the first element



predicate returns truthy for. The predicate is invoked with three



arguments: (value, index|key, collection).

Since​

0.1.0

Arguments​

  1. predicate (Function): The function invoked per iteration.
  2. collection (Array|Object): The collection to inspect.

Returns​

(*): Returns the matched element, else undefined.

Example​

var users = [
  { 'user': 'barney',  'age': 36, 'active': true },
  { 'user': 'fred',    'age': 40, 'active': false },
  { 'user': 'pebbles', 'age': 1,  'active': true }
];

_.find(function(o) { return o.age < 40; }, users);
// => object for 'barney'

// The `_.matches` iteratee shorthand.
_.find({ 'age': 1, 'active': true }, users);
// => object for 'pebbles'

// The `_.matchesProperty` iteratee shorthand.
_.find(['active', false], users);
// => object for 'fred'

// The `_.property` iteratee shorthand.
_.find('active', users);
// => object for 'barney'