4.17.11
3.10.1
2.4.2
1.3.1

_.find(collection, [predicate=_.identity], [fromIndex=0])

sourcenpm package

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

argument
collection
[predicate=_.identity]
[fromIndex=0]
type
(Array|Object)
Function
number
description
The collection to inspect.
The function invoked per iteration.
The index to search from.

Returns

(array)

Example

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

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

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

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

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

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

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

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

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

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