4.17.11
3.10.1
2.4.2
1.3.1
_.matches(source)
Creates a function that performs a partial deep comparison between a given
object and source
, returning true
if the given object has equivalent
property values, else false
.
Note: The created function is equivalent to _.isMatch
with source
partially applied.
Partial comparisons will match empty array and empty object source
values against any array or object value, respectively. See _.isEqual
for a list of supported value comparisons.
Since
3.0.0
Arguments
argument
source
type
Object
description
The object of property values to match.
Returns
(array)
Example
var objects = [
{ a: 1, b: 2, c: 3 },
{ a: 4, b: 5, c: 6 },
];
_.filter(
objects,
_.matches({ a: 4, c: 6 })
);
// => [{ 'a': 4, 'b': 5, 'c': 6 }]
var objects = [
{ a: 1, b: 2, c: 3 },
{ a: 4, b: 5, c: 6 },
];
_.filter(objects, _.matches({ a: 4, c: 6 }));
// => [{ 'a': 4, 'b': 5, 'c': 6 }]