38 lines
1.1 KiB
JavaScript
38 lines
1.1 KiB
JavaScript
|
import { cloneDeep } from "../../object/cloneDeep.mjs";
|
||
|
|
import { isMatch } from "./isMatch.mjs";
|
||
|
|
//#region src/compat/predicate/matches.ts
|
||
|
|
/**
|
||
|
|
* Creates a function that performs a deep comparison between a given target and the source object.
|
||
|
|
*
|
||
|
|
* @template T
|
||
|
|
* @template V
|
||
|
|
* @param {T} source - The source object to create the matcher from.
|
||
|
|
* @returns {(target: V) => boolean} Returns a function that takes a target object and returns `true` if the target matches the source, otherwise `false`.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Basic usage
|
||
|
|
* const matcher = matches({ a: 1, b: 2 });
|
||
|
|
* matcher({ a: 1, b: 2, c: 3 }); // true
|
||
|
|
* matcher({ a: 1, c: 3 }); // false
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Matching arrays
|
||
|
|
* const arrayMatcher = matches([1, 2, 3]);
|
||
|
|
* arrayMatcher([1, 2, 3, 4]); // true
|
||
|
|
* arrayMatcher([4, 5, 6]); // false
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Matching objects with nested structures
|
||
|
|
* const nestedMatcher = matches({ a: { b: 2 } });
|
||
|
|
* nestedMatcher({ a: { b: 2, c: 3 } }); // true
|
||
|
|
* nestedMatcher({ a: { c: 3 } }); // false
|
||
|
|
*/
|
||
|
|
function matches(source) {
|
||
|
|
source = cloneDeep(source);
|
||
|
|
return (target) => {
|
||
|
|
return isMatch(target, source);
|
||
|
|
};
|
||
|
|
}
|
||
|
|
//#endregion
|
||
|
|
export { matches };
|