43 lines
1.9 KiB
JavaScript
43 lines
1.9 KiB
JavaScript
|
import { difference } from "../../array/difference.mjs";
|
||
|
|
import { differenceWith as differenceWith$1 } from "../../array/differenceWith.mjs";
|
||
|
|
import { isArrayLikeObject } from "../predicate/isArrayLikeObject.mjs";
|
||
|
|
import { last } from "./last.mjs";
|
||
|
|
import { flattenArrayLike } from "../_internal/flattenArrayLike.mjs";
|
||
|
|
//#region src/compat/array/differenceWith.ts
|
||
|
|
/**
|
||
|
|
* Computes the difference between the primary array and one or more arrays using an optional comparator function.
|
||
|
|
*
|
||
|
|
* @template T
|
||
|
|
* @param {ArrayLike<T> | null | undefined} array - The primary array to compare elements against.
|
||
|
|
* @param {...Array<ArrayLike<unknown> | ((a: unknown, b: unknown) => boolean)>} values - One or more arrays to compare with the primary array, and an optional comparator function to determine if two elements are considered equal.
|
||
|
|
* @returns {T[]} A new array containing the elements from the primary array that do not match any elements in the provided arrays or those compared using the comparator function.
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Example with a comparator function
|
||
|
|
* const array = [{ id: 1 }, { id: 2 }, { id: 3 }];
|
||
|
|
* const values1 = [{ id: 2 }];
|
||
|
|
* const values2 = [{ id: 3 }];
|
||
|
|
* const comparator = (a, b) => a.id === b.id;
|
||
|
|
*
|
||
|
|
* const result = differenceWith(array, values1, values2, comparator);
|
||
|
|
* // result will be [{ id: 1 }]
|
||
|
|
*
|
||
|
|
* @example
|
||
|
|
* // Example without a comparator function
|
||
|
|
* const array = [1, 2, 3];
|
||
|
|
* const values1 = [2];
|
||
|
|
* const values2 = [3];
|
||
|
|
*
|
||
|
|
* const result = differenceWith(array, values1, values2);
|
||
|
|
* // result will be [1]
|
||
|
|
*/
|
||
|
|
function differenceWith(array, ...values) {
|
||
|
|
if (!isArrayLikeObject(array)) return [];
|
||
|
|
const comparator = last(values);
|
||
|
|
const flattenedValues = flattenArrayLike(values);
|
||
|
|
if (typeof comparator === "function") return differenceWith$1(Array.from(array), flattenedValues, comparator);
|
||
|
|
return difference(Array.from(array), flattenedValues);
|
||
|
|
}
|
||
|
|
//#endregion
|
||
|
|
export { differenceWith };
|