50 lines
1.9 KiB
JavaScript
50 lines
1.9 KiB
JavaScript
|
var baseIsMatch = require('../internal/baseIsMatch'),
|
||
|
|
bindCallback = require('../internal/bindCallback'),
|
||
|
|
getMatchData = require('../internal/getMatchData');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Performs a deep comparison between `object` and `source` to determine if
|
||
|
|
* `object` contains equivalent property values. If `customizer` is provided
|
||
|
|
* it is invoked to compare values. If `customizer` returns `undefined`
|
||
|
|
* comparisons are handled by the method instead. The `customizer` is bound
|
||
|
|
* to `thisArg` and invoked with three arguments: (value, other, index|key).
|
||
|
|
*
|
||
|
|
* **Note:** This method supports comparing properties of arrays, booleans,
|
||
|
|
* `Date` objects, numbers, `Object` objects, regexes, and strings. Functions
|
||
|
|
* and DOM nodes are **not** supported. Provide a customizer function to extend
|
||
|
|
* support for comparing other values.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @category Lang
|
||
|
|
* @param {Object} object The object to inspect.
|
||
|
|
* @param {Object} source The object of property values to match.
|
||
|
|
* @param {Function} [customizer] The function to customize value comparisons.
|
||
|
|
* @param {*} [thisArg] The `this` binding of `customizer`.
|
||
|
|
* @returns {boolean} Returns `true` if `object` is a match, else `false`.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* var object = { 'user': 'fred', 'age': 40 };
|
||
|
|
*
|
||
|
|
* _.isMatch(object, { 'age': 40 });
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isMatch(object, { 'age': 36 });
|
||
|
|
* // => false
|
||
|
|
*
|
||
|
|
* // using a customizer callback
|
||
|
|
* var object = { 'greeting': 'hello' };
|
||
|
|
* var source = { 'greeting': 'hi' };
|
||
|
|
*
|
||
|
|
* _.isMatch(object, source, function(value, other) {
|
||
|
|
* return _.every([value, other], RegExp.prototype.test, /^h(?:i|ello)$/) || undefined;
|
||
|
|
* });
|
||
|
|
* // => true
|
||
|
|
*/
|
||
|
|
function isMatch(object, source, customizer, thisArg) {
|
||
|
|
customizer = typeof customizer == 'function' ? bindCallback(customizer, thisArg, 3) : undefined;
|
||
|
|
return baseIsMatch(object, getMatchData(source), customizer);
|
||
|
|
}
|
||
|
|
|
||
|
|
module.exports = isMatch;
|