4.17.11
3.10.1
2.4.2
1.3.1

_.matchesProperty(path, srcValue)

Creates a function that performs a partial deep comparison between the value at path of a given object to srcValue, returning true if the object value is equivalent, else false.

Note: Partial comparisons will match empty array and empty object srcValue values against any array or object value, respectively. See _.isEqual for a list of supported value comparisons.

Since

3.2.0

Arguments

argument
path
srcValue
type
(Array|string)
*
description
The path of the property to get.
The value to match.

Returns

(array)

Example

var objects = [
  { a: 1, b: 2, c: 3 },
  { a: 4, b: 5, c: 6 },
];

_.find(
  objects,
  _.matchesProperty("a", 4)
);
// => { 'a': 4, 'b': 5, 'c': 6 }
var objects = [
  { a: 1, b: 2, c: 3 },
  { a: 4, b: 5, c: 6 },
];

_.find(objects, _.matchesProperty("a", 4));
// => { 'a': 4, 'b': 5, 'c': 6 }