51 lines
2.1 KiB
JavaScript
51 lines
2.1 KiB
JavaScript
|
const require_toKey = require("../_internal/toKey.js");
|
||
|
|
const require_get = require("../object/get.js");
|
||
|
|
const require_isMatch = require("./isMatch.js");
|
||
|
|
const require_cloneDeep = require("../object/cloneDeep.js");
|
||
|
|
const require_has = require("../object/has.js");
|
||
|
|
//#region src/compat/predicate/matchesProperty.ts
|
||
|
|
/**
|
||
|
|
* Creates a function that checks if a given target object matches a specific property value.
|
||
|
|
*
|
||
|
|
* The returned function takes a target object and determines if the property at the
|
||
|
|
* specified path within the target object is equal to the given value.
|
||
|
|
*
|
||
|
|
* @param {PropertyPath} property - The property path to check within the target object.
|
||
|
|
* This can be a single property key or an array of property keys.
|
||
|
|
* @param {T} source - The value to compare against the property value in the target object.
|
||
|
|
*
|
||
|
|
* @returns {(target?: V) => boolean} - A function that takes a target object and returns
|
||
|
|
* `true` if the property value at the given path in the target object matches the provided value,
|
||
|
|
* otherwise returns `false`.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Using a single property key
|
||
|
|
* const checkName = matchesProperty('name', 'Alice');
|
||
|
|
* console.log(checkName({ name: 'Alice' })); // true
|
||
|
|
* console.log(checkName({ name: 'Bob' })); // false
|
||
|
|
*
|
||
|
|
* // Using an array of property keys
|
||
|
|
* const checkNested = matchesProperty(['address', 'city'], 'New York');
|
||
|
|
* console.log(checkNested({ address: { city: 'New York' } })); // true
|
||
|
|
* console.log(checkNested({ address: { city: 'Los Angeles' } })); // false
|
||
|
|
*/
|
||
|
|
function matchesProperty(property, source) {
|
||
|
|
switch (typeof property) {
|
||
|
|
case "object":
|
||
|
|
if (Object.is(property?.valueOf(), -0)) property = "-0";
|
||
|
|
break;
|
||
|
|
case "number":
|
||
|
|
property = require_toKey.toKey(property);
|
||
|
|
break;
|
||
|
|
}
|
||
|
|
source = require_cloneDeep.cloneDeep(source);
|
||
|
|
return function(target) {
|
||
|
|
const result = require_get.get(target, property);
|
||
|
|
if (result === void 0) return require_has.has(target, property);
|
||
|
|
if (source === void 0) return result === void 0;
|
||
|
|
return require_isMatch.isMatch(result, source);
|
||
|
|
};
|
||
|
|
}
|
||
|
|
//#endregion
|
||
|
|
exports.matchesProperty = matchesProperty;
|